La API REST v1 permite a tus propios sistemas gestionar códigos, leer estadísticas de escaneo, subir archivos alojados, registrar conversiones y gestionar endpoints de webhook. El acceso a la API depende de tu plan.

Crea una clave

  1. Abre Claves API en el panel y crea una clave.
  2. Elige el alcance. Las claves de Lectura solo pueden llamar a endpoints GET. Las claves Completas pueden crear, actualizar y eliminar.
  3. Copia la clave cuando se muestre. El secreto completo se muestra una vez al crearla y nunca se almacena ni se muestra de nuevo.
Las claves API, con el alcance y la hora de último uso de cada clave
Las claves API, con el alcance y la hora de último uso de cada clave

Llama a la API

Envía la clave como encabezado de autorización:

bash
curl https://dynamihost.com/api/v1/codes \
  -H "Authorization: Bearer <redacted>"

Crea un código:

bash
curl -X POST https://dynamihost.com/api/v1/codes \
  -H "Authorization: Bearer <redacted>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Counter menu", "type": "url", "destination": "https://example.com/menu"}'

Reglas que ahorran tiempo de depuración

  • Usa el alcance más estrecho que funcione. Un trabajo de informes necesita una clave de lectura, no una completa.
  • Una clave por sistema. Revocar una clave filtrada no debería derribar tres integraciones.
  • Respeta los límites de velocidad. Las respuestas incluyen el estado del límite; reduce el ritmo en lugar de reintentar en un bucle cerrado.
  • Rota las claves como contraseñas. Crea la clave nueva, despliégala, confirma que las llamadas funcionan y después revoca la antigua.