Límite de peticiones
La cuota es por credencial y la anuncian las cabeceras X-RateLimit-*.
La cuota se cuenta contra tu credencial, no contra tu IP: dos partners detrás de la misma salida a internet no se consumen la cuota mutuamente. Y es por credencial, no por endpoint: se reparte entre todas las rutas.
El número exacto lo anuncia cada respuesta en X-RateLimit-Limit, y esa es la
fuente de verdad. Puede diferir entre ambientes y entre cuentas: si tu volumen
lo necesita, pedinos más cuota y la ampliamos para tu credencial, sin que tengas
que cambiar nada. No lo escribas fijo en tu código: leelo de la cabecera. Hoy la
ventana es de un minuto y el límite está en el orden de las decenas de
peticiones, suficiente para un flujo normal de sincronización y creación de
órdenes.
Toda respuesta trae:
| Header | Contenido |
|---|---|
X-RateLimit-Limit | Cuota del periodo |
X-RateLimit-Remaining | Peticiones restantes |
X-RateLimit-Reset | Segundos hasta que se reinicia la ventana |
Retry-After | Solo en 429: segundos a esperar |
Cuando recibas un 429, esperá los segundos que indique Retry-After antes de
reintentar. Si tu volumen necesita más de lo que anuncian las cabeceras,
hablalo con nosotros antes de subir el ritmo.