Buckets
La aplicación tiene su propio bucket, y la tienda uno para todas sus aplicaciones juntas. Una solicitud toma un token de los dos; las lecturas y las escrituras los comparten.
| Bucket | Solicitudes por minuto | Seguidas |
|---|---|---|
| Cada aplicación | 300 | 100 |
| La tienda, todas las aplicaciones juntas | 1200 | 400 |
"Seguidas" es cuántas solicitudes pasan sin pausa; después, el bucket se rellena al ritmo por minuto.
Encabezados
Cada respuesta informa los dos buckets, según el borrador IETF de los encabezados RateLimit: RateLimit-Policy nombra cada bucket con su cuota por ventana, q y w en segundos; RateLimit dice cuántas solicitudes quedan seguidas, r, y en cuántos segundos el bucket vuelve a estar lleno, t. Frená según r en lugar de esperar un rechazo.
Ante un 429
Una solicitud por encima del límite recibe 429 too_many_requests: policy nombra el bucket que se agotó y Retry-After cuántos segundos esperar. Una solicitud rechazada no toma token del otro bucket.
curl "https://api.saleya.app/v1/products?limit=250" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"HTTP/1.1 429 Too Many Requests
Retry-After: 1
RateLimit-Policy: "app";q=300;w=60, "store";q=1200;w=60
RateLimit: "app";r=0;t=20, "store";r=310;t=5
{
"type": "too_many_requests",
"title": "Too many requests",
"status": 429,
"detail": "The app rate limit is exhausted. Retry after the number of seconds in the Retry-After header.",
"policy": "app"
}Las solicitudes rechazadas en la entrada — un 401, o un 403 de una dirección no permitida o de un plan sin API — se cuentan por dirección, aparte de los buckets. Después de 60 en un minuto, la dirección recibe 429 con policy igual a rejected hasta que termine el minuto. Las solicitudes con un token vigente no se cuentan. Corregí la causa que indicó el 401 o 403 en vez de repetir la solicitud.
Menos solicitudes
- Miles de registros: una operación masiva en lugar de una solicitud por registro.
- Cambios: webhooks y el cursor de sincronización en lugar de consultar los listados una y otra vez.
- Páginas de hasta 250 registros en lugar del tamaño por defecto.
- Varias integraciones de una tienda comparten el bucket de la tienda: repartí los trabajos pesados en el tiempo.
Los demás topes y plazos de conservación de la API están en la tabla de límites.