Límites de solicitudes

Las solicitudes se limitan con dos token buckets a la vez: uno de la aplicación y uno de la tienda. Cada respuesta dice cuánto queda, así una integración puede frenar antes de que la rechacen.

Cargando el índice de búsqueda…

Límites de solicitudes

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.

Scale
BucketSolicitudes por minutoSeguidas
Cada aplicación300100
La tienda, todas las aplicaciones juntas1200400

"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.

Solicitud
curl "https://api.saleya.app/v1/products?limit=250" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Respuesta
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.

Siguiente guíaVersiones de la API