Saltar al contenido

Límites de frecuencia

Cada llamada cuenta para un límite, por cliente y sumando todas tus claves de API, en minutos de reloj. Estos son los límites vigentes.

GET /account, GET /checkers, GET /orders, GET /orders/{id}
60 por minuto
GET /orders/{id}/results
30 por minuto
POST /uploads
10 por minuto
POST /estimates
10 por minuto
Pedidos nuevos con POST /orders
10 por minuto
Partes de tarea sin terminar a la vez, desde la API
20 a la vez
Solicitudes con una clave de API incorrecta, por dirección IP
20 por minuto

Qué puede indicarte una respuesta

Pueden faltar, por ejemplo en un pedido repetido, así que no dependas de ellos.

  • RateLimit-Limit: el límite para este tipo de llamada.
  • RateLimit-Remaining: cuántas quedan este minuto.
  • RateLimit-Reset: los segundos hasta que el recuento vuelve a empezar.

Cuando superas un límite

Recibes 429 rate_limited con Retry-After, los segundos que debes esperar. Esta solicitud no hizo nada y no cobró nada. Espera ese tiempo y vuelve a enviarla, con la misma Idempotency-Key si es un pedido.

Reintentos

Repetir un pedido ya realizado, o uno que pasó estos límites y perdió su respuesta, no cuenta para el límite de pedidos, así que un reintento seguro no se rechaza por ser un reintento. Todas las solicitudes para realizar un pedido están además sujetas a seis veces el límite de pedidos, y como mínimo a 60 por minuto.

Pedidos abiertos

Un pedido grande son varias partes de tarea, una por cada 1.000.000 de entradas. Por encima del límite de partes abiertas recibes 429 too_many_open_orders: espera a que algunas terminen. Un solo pedido grande puede superar el límite cuando no tienes nada más abierto.

¿Necesitas más?

Contáctanos y cuéntanos qué estás creando.

En esta página