Documentação da API Mokapen

Limite por minuto

Os clients padrão da API ficam limitados a 60 requisições por minuto por client ou usuário autenticado.

Os clients mobile com header X-Client: mobile podem ter um limite maior (200 requisições por minuto).

HTTP/1.1 429 Too Many Requests

{
  "status": false,
  "message": "Too Many Requests",
  "max_attempts": 60,
  "remaining": 0,
  "retry_after": "45 seconds"
}

Cota diária (por plano)

Cada organização tem uma cota diária de requisições da API determinada pelo plano Mokapen. A cota vale por organização por dia civil (UTC).

Se a cota diária for ultrapassada, a API responde 429 Too Many Requests com a mensagem quota exceeded.

HTTP/1.1 429 Too Many Requests

{
  "message": "Quota exceeded",
  "API daily request limit exceeded.\n": 2000
}

Boas práticas

• Coloque as respostas em cache quando der, em vez de fazer polling frequente.
• Implemente exponential backoff em caso de respostas 429.
• Use webhooks para integrações event-driven em vez de polling repetido.
• Peça só os scopes necessários.