Limite

O Ocoya aplica um limite de taxa global por utilizador de 60 requests per minute para pedidos REST API que usem a mesma API key.

Se espera picos de tráfego, coloque os pedidos em fila e use uma estratégia de backoff em vez de voltar a tentar imediatamente.

Resposta de Rate Limit

Quando o limite é excedido, a API devolve 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

HeaderMeaning
X-RateLimit-LimitNúmero máximo de pedidos à API permitidos por minuto.
X-RateLimit-RemainingNúmero restante de pedidos à API na janela atual.
X-RateLimit-ResetTimestamp que indica quando o limite restante é reiniciado.

Back off after 429

Espere até ao fim da janela de reset antes de voltar a tentar os pedidos.

Avoid polling aggressively

Dê preferência a workflows orientados a eventos e jobs agendados em vez de polling de alta frequência.

Batch where possible

Reutilize os IDs de brand e de social profile em vez de os ir buscar antes de cada criação de post.