Límites de solicitudes y errores
Actualizado hace 3 semanas
Al superar el límite por clave, la API responde con 429 y Retry-After. A continuación se indican todos los códigos de estado y qué hacer en cada caso.
Límites de solicitudes
Cada clave tiene un límite por minuto, establecido cuando se emite la clave. Al superar el límite, la API responde:
HTTP/1.1 429 Too Many Requests
Retry-After: 23
{ "error": "Too Many Requests", "retry_after_seconds": 23 }Espere los segundos indicados en Retry-After y vuelva a intentar la misma solicitud; no se escribió nada. La ventana corresponde a un minuto natural fijo, por lo que un grupo de solicitudes que atraviese el cambio de minuto puede superar brevemente el límite.
¿Está planificando una carga histórica o una resincronización completa? Pídanos aumentar primero su límite. El nuevo límite entra en vigor en un plazo de un minuto.
Códigos de estado
Código | Significado | Qué hacer |
|---|---|---|
| Aceptada. Lea | Nada. |
| JSON con formato incorrecto o falta un campo obligatorio; | Corrija el cuerpo. No vuelva a intentarlo sin cambios. |
| Falta | Compruebe el encabezado. Si la clave ha caducado o se ha desactivado, pídanos una nueva. |
| El cuerpo o la URL indican un tenant distinto al asociado a la clave, o el tipo de clave no es válido para el endpoint. | Compruebe |
| Límite de solicitudes. No se escribió nada. | Espere los segundos indicados en |
| Fallo inesperado; el cuerpo incluye un | Vuelva a intentarlo con una espera incremental. Si el problema persiste, envíe el |
La respuesta 200
{ "status": "processed", "message": "Load processed", "permalink": "1083452-acme" }
| Cuándo |
|---|---|
| Almacenado (creado o actualizado). |
| Se dejó sin cambios: el registro cambió en TrackFlo después de su |
| Una actualización de carga cuyo permalink ya estaba almacenado. |