​
Límite

Ocoya aplica un límite global de 60 requests per minute para solicitudes REST API que usen la misma API key.

Si esperas picos, pon las solicitudes en cola y usa una estrategia de backoff en lugar de reintentar inmediatamente.

​
Respuesta de límite de uso

Cuando se supera el límite, la API devuelve 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."
}

​
Cabeceras

HeaderMeaning
X-RateLimit-LimitNúmero máximo de solicitudes a la API permitidas por minuto.
X-RateLimit-RemainingNúmero restante de solicitudes a la API en la ventana actual.
X-RateLimit-ResetMarca de tiempo que indica cuándo se restablece el límite restante.

​
Manejo recomendado

Back off after 429

Espera hasta la ventana de reseteo antes de reintentar las solicitudes.

Avoid polling aggressively

Prefiere flujos de trabajo basados en eventos y tareas programadas en lugar de polling de alta frecuencia.

Batch where possible

Reutiliza los IDs de marca y de perfiles sociales en lugar de obtenerlos antes de cada creación de post.