​
Limit

Ocoya applica un rate limit globale per utente di 60 requests per minute per le richieste REST API che usano la stessa API key.

Se ti aspetti picchi di traffico, metti in coda le richieste e usa una strategia di backoff invece di riprovare immediatamente.

​
Rate Limit Response

Quando il limite viene superato, l’API restituisce 429 Too Many Requests.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
{
  "message": "You've exceeded the request limit."
}

​
Headers

HeaderSignificato
X-RateLimit-LimitNumero massimo di richieste API consentite al minuto.
X-RateLimit-RemainingNumero rimanente di richieste API nella finestra corrente.
X-RateLimit-ResetTimestamp che indica quando il limite rimanente viene azzerato.

Riduci dopo 429

Attendi fino alla finestra di reset prima di riprovare le richieste.

Evita polling aggressivo

Preferisci workflow event-driven e job schedulati invece di polling ad alta frequenza.

Fai batch quando possibile

Riutilizza gli ID di brand e social profile invece di recuperarli prima di ogni creazione di post.