Documentación de la API Mokapen

Límite por minuto

Los clients estándar de la API están limitados a 60 solicitudes por minuto por client o usuario autenticado.

Los clients mobile con header X-Client: mobile pueden tener un límite más alto (200 solicitudes por minuto).

HTTP/1.1 429 Too Many Requests

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

Cuota diaria (por plan)

Cada organización tiene una cuota diaria de solicitudes de la API determinada por el plan Mokapen. La cuota aplica por organización por día calendario (UTC).

Si se supera la cuota diaria, la API responde 429 Too Many Requests con el mensaje quota exceeded.

HTTP/1.1 429 Too Many Requests

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

Buenas prácticas

• Pon en caché las respuestas cuando sea posible en lugar de hacer polling frecuente.
• Implementa exponential backoff ante respuestas 429.
• Usa webhooks para integraciones event-driven en lugar de polling repetido.
• Solicita solo los scopes necesarios.