​
Limit

Ocoya stosuje globalny limit 60 requests per minute dla zapytań REST API używających tego samego klucza API.

Jeśli spodziewasz się skoków ruchu, kolejkować zapytania i używaj strategii backoff zamiast ponawiania ich od razu.

​
Odpowiedź przy przekroczeniu limitu

Gdy limit zostanie przekroczony, API zwraca 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."
}

​
Nagłówki

HeaderMeaning
X-RateLimit-LimitMaksymalna liczba zapytań API dozwolonych na minutę.
X-RateLimit-RemainingPozostała liczba zapytań API w bieżącym oknie.
X-RateLimit-ResetTimestamp wskazujący, kiedy pozostały limit zostanie zresetowany.

​
Zalecana obsługa

Back off after 429

Poczekaj do końca okna resetu, zanim ponowisz zapytania.

Avoid polling aggressively

Preferuj przepływy zdarzeniowe (event-driven) i zadania cykliczne zamiast częstego odpytywania.

Batch where possible

Ponownie wykorzystuj identyfikatory brand i social profile zamiast pobierać je przed każdym tworzeniem posta.