​
Limit

Ocoya wendet ein globales User-Rate-Limit von 60 requests per minute für REST-API-Anfragen an, die denselben API-Key verwenden.

Wenn du Lastspitzen erwartest, solltest du Anfragen in eine Queue stellen und eine Backoff-Strategie verwenden, anstatt sie sofort erneut zu senden.

​
Rate Limit Response

Wenn das Limit überschritten wird, gibt die API 429 Too Many Requests zurück.

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

HeaderMeaning
X-RateLimit-LimitMaximale Anzahl der pro Minute erlaubten API-Requests.
X-RateLimit-RemainingVerbleibende Anzahl der API-Requests im aktuellen Zeitfenster.
X-RateLimit-ResetZeitstempel, der angibt, wann das verbleibende Limit zurückgesetzt wird.

Back off after 429

Warte bis zum Ende des Reset-Fensters, bevor du Anfragen erneut sendest.

Avoid polling aggressively

Verwende nach Möglichkeit ereignisgesteuerte Workflows und geplante Jobs anstelle von High-Frequency-Polling.

Batch where possible

Verwende Brand- und Social-Profile-IDs wieder, anstatt sie vor jeder Post-Erstellung neu abzurufen.