Documentazione API Mokapen

Limite al minuto

I client API standard sono limitati a 60 richieste al minuto per client o utente autenticato.

I client mobile con header X-Client: mobile possono avere un limite più alto (200 richieste al minuto).

HTTP/1.1 429 Too Many Requests

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

Quota giornaliera (per piano)

Ogni organizzazione ha una quota giornaliera di richieste API determinata dal piano Mokapen. La quota si applica per organizzazione per giorno solare (UTC).

Se la quota giornaliera viene superata, l'API risponde 429 Too Many Requests con messaggio quota exceeded.

HTTP/1.1 429 Too Many Requests

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

Best practice

• Metti in cache le risposte dove possibile invece di fare polling frequente.
• Implementa exponential backoff in caso di risposte 429.
• Usa i webhook per integrazioni event-driven invece del polling ripetuto.
• Richiedi solo gli scope necessari.