API Mosaqo
API pública e webhooks para automação de QR
A API pública Mosaqo usa chaves com escopo de espaço de trabalho. Comece com o escopo mínimo, use Idempotency-Key para gravações e respeite Retry-After quando a taxa for limitada.
VISÃO RÁPIDA
O que isso muda na prática
01
Autenticação e escopos
Envie o segredo em X-Mosaqo-API-Key. Os escopos disponíveis incluem qr:read, qr:write, exports:read e analytics:read. As chaves podem expirar, ser revogadas ou usar uma lista de permissões de IP.
- Nunca coloque um segredo no JavaScript do cliente
- Use uma chave por integração
- Rodar após suspeita de exposição
02
Novas tentativas de gravação seguras
As solicitações de criação e publicação requerem uma chave de idempotência entre 1 e 128 caracteres. Reutilize a chave apenas para tentar novamente a carga idêntica dentro de 24 horas.
03
Limites e erros de taxa
No HTTP 429, leia Retry-After e tente novamente com espera. Um 401 geralmente indica uma chave ausente, revogada, expirada, restrita ou com escopo insuficiente.
04
Webhooks
Inscreva-se apenas nos eventos necessários, aceite-os em HTTPS e responda rapidamente. Mosaqo registra o status de entrega e oferece suporte à reprodução do espaço de trabalho.
FAQ
Perguntas frequentes
Onde está o contrato completo da API?
O contrato OpenAPI 3.1 tem versão com a API Mosaqo. Crie uma chave no espaço de trabalho web e use o contrato publicado para obter detalhes do terminal.
PRÓXIMO PASSO