Límites de solicitudes y errores

Actualizado hoy

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

Los límites son por clave y por minuto y se establecen al emitir 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. Si necesita un límite más alto, solicítelo a TrackFlo.

Códigos de estado

Código	Significado	Qué hacer
`200`	Aceptada. Consulte `status`: `processed`, `skipped` o `duplicate`.	Nada. `skipped` y `duplicate` son situaciones normales, no errores.
`400`	JSON con formato incorrecto o falta un campo obligatorio; `error` indica cuál es.	Corrija el cuerpo. No vuelva a intentarlo sin cambios.
`401`	Falta `X-API-Key` o se desconoce su valor.	Compruebe el encabezado y que la clave siga activa.
`403`	El cuerpo o la URL indican un tenant distinto del asociado a la clave.	Compruebe `company_permalink` y cada sufijo `*_permalink`.
`429`	Límite de solicitudes.	Espere los segundos indicados en `Retry-After` y vuelva a intentarlo.
`500`	Error inesperado; el cuerpo incluye un `error_id`.	Vuelva a intentarlo aplicando una espera progresiva. Si el problema persiste, envíe el `error_id` a TrackFlo.

La respuesta `200`

{ "status": "processed", "message": "Load processed", "permalink": "1083452-acme" }

`status`	Cuándo
`processed`	Almacenado (creado o actualizado).
`skipped`	Se dejó sin cambios: el registro cambió en TrackFlo después de su `sync_run_time`, o los contactos del transportista se administran dentro de TrackFlo.
`duplicate`	Una actualización de carga cuyo permalink ya se había almacenado.

¿Te fue útil?

Límites de solicitudes y errores