Limite

Ocoya applique une limite de débit utilisateur globale de 60 requests per minute pour les requêtes REST API utilisant la même clé API.

Si vous anticipez des pics, mettez les requêtes en file d’attente et utilisez une stratégie de backoff plutôt que de réessayer immédiatement.

Réponse en cas de dépassement de la limite

Lorsque la limite est dépassée, l’API renvoie 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."
}

En-têtes

HeaderMeaning
X-RateLimit-LimitNombre maximal de requêtes API autorisées par minute.
X-RateLimit-RemainingNombre restant de requêtes API dans la fenêtre actuelle.
X-RateLimit-ResetHorodatage indiquant le moment où la limite restante est réinitialisée.

Gestion recommandée

Se mettre en attente après un 429

Patientez jusqu’à la fin de la fenêtre de réinitialisation avant de réessayer les requêtes.

Éviter les interrogations agressives

Privilégiez des workflows pilotés par les événements et des tâches planifiées plutôt qu’un polling à haute fréquence.

Regrouper quand c’est possible

Réutilisez les IDs de brand et de profil social au lieu de les récupérer avant chaque création de post.