Límites de frecuencia e ID de solicitud

60 solicitudes por minuto y por clave, Retry-After y X-Request-Id en cada respuesta.

​

Límites de frecuencia

Cada credencial PMS puede hacer 60 solicitudes por minuto. El límite es por clave, así que dos claves de tu PMS no lo comparten.

GET /v1/health no necesita clave, así que se limita por IP de cliente, también a 60 por minuto.

Por encima del límite, Tatallo responde 429 con el código rate_limited y una cabecera Retry-After: el número de segundos hasta que empieza el minuto siguiente. Espera ese tiempo y continúa.

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-Request-Id: c2b7e1d4-8a3f-4e6b-9d2c-7f1a5e9b3c08

{"error":{"code":"rate_limited","message":"Too many requests. Retry after the number of seconds in Retry-After.","request_id":"c2b7e1d4-8a3f-4e6b-9d2c-7f1a5e9b3c08"}}

Espacia la sincronización completa de una cartera grande de propiedades con limit=100: una solicitud devuelve hasta 100 propiedades.

​

ID de solicitud

Toda respuesta lleva una cabecera X-Request-Id, errores y 429 incluidos. Siempre es un UUID, y el request_id de un error contiene el mismo valor.

Para correlacionar las solicitudes de extremo a extremo, envía tu propio UUID en X-Request-Id: Tatallo devuelve sin cambios un UUID bien formado. Cualquier otro valor se sustituye por un UUID que genera Tatallo, de modo que la cabecera siempre se interpreta igual.

curl -s -i "$TATALLO_BASE_URL/v1/me" \
  -H "Authorization: Bearer $TATALLO_API_KEY" \
  -H "X-Request-Id: 2f1c6d3a-9b7e-4c55-8e21-0d4a6b9f7c13"

Cita el ID de solicitud siempre que contactes con soporte.