API Mosaqo
API pública y webhooks para la automatización de QR
Mosaqo La API pública utiliza claves con ámbito de espacio de trabajo. Comience con el alcance mínimo, use Idempotency-Key para escrituras y respete Retry-After cuando la tasa sea limitada.
VISTA RÁPIDA
Qué cambia esto en la práctica
01
Autenticación y alcances
Envía el secreto en X-Mosaqo-API-Key. Los alcances disponibles incluyen qr:read, qr:write, exports:read y Analytics:read. Las claves pueden caducar, revocarse o utilizar una lista de IP permitidas.
- Nunca coloques un secreto en el JavaScript del cliente
- Utilice una clave por integración
- Rotar después de sospecha de exposición
02
Reintentos de escritura segura
Las solicitudes de creación y publicación requieren una clave de idempotencia de entre 1 y 128 caracteres. Reutilice la clave solo para volver a intentar la carga útil idéntica dentro de las 24 horas.
03
Límites de tarifas y errores
En HTTP 429, lea Reintentar después y vuelva a intentarlo con retroceso. Un 401 generalmente indica una clave faltante, revocada, caducada, restringida o con un alcance insuficiente.
04
Webhooks
Suscríbete solo a los eventos necesarios, acéptalos en HTTPS y responde rápidamente. Mosaqo registra el estado de entrega y admite la reproducción desde el espacio de trabajo.
FAQ
Preguntas frecuentes
¿Dónde está el contrato API completo?
El contrato OpenAPI 3.1 está versionado con la API Mosaqo. Cree una clave en el espacio de trabajo web y utilice el contrato publicado para obtener detalles del punto final.
SIGUIENTE PASO