Limiti di frequenza e ID delle richieste

60 richieste al minuto per chiave, Retry-After e X-Request-Id su ogni risposta.

​

Limiti di frequenza

Ogni credenziale PMS può fare 60 richieste al minuto. Il limite è per chiave, quindi due chiavi del tuo PMS non lo condividono.

GET /v1/health non richiede una chiave, quindi il limite è per IP del client, sempre 60 al minuto.

Oltre il limite, Tatallo risponde 429 con il codice rate_limited e un header Retry-After: i secondi che mancano all’inizio del minuto successivo. Attendi quel tempo, poi continua.

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"}}

Per sincronizzare un portafoglio ampio, procedi con limit=100: una richiesta restituisce fino a 100 proprietà.

​

ID delle richieste

Ogni risposta porta un header X-Request-Id, errori e 429 compresi. È sempre un UUID, e il request_id di un errore contiene lo stesso valore.

Per correlare le richieste da un capo all’altro, invia un tuo UUID in X-Request-Id: Tatallo restituisce invariato un UUID ben formato. Qualsiasi altro valore viene sostituito da un UUID generato da Tatallo, così l’header si interpreta sempre allo stesso modo.

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

Cita l’ID della richiesta ogni volta che contatti il supporto.