Limites de débit et identifiants de requête

60 requêtes par minute et par clé, Retry-After, et X-Request-Id sur chaque réponse.

​

Limites de débit

Chaque identifiant PMS peut effectuer 60 requêtes par minute. La limite s’applique par clé : deux clés de votre PMS ne la partagent donc pas.

GET /v1/health n’exige aucune clé : il est donc limité par adresse IP du client, là aussi à 60 par minute.

Au-delà de la limite, Tatallo répond 429 avec le code rate_limited et un en-tête Retry-After : le nombre de secondes avant le début de la minute suivante. Attendez ce délai, puis poursuivez.

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

Cadencez la synchronisation complète d’un grand parc avec limit=100 : une requête renvoie jusqu’à 100 propriétés.

​

Identifiants de requête

Chaque réponse porte un en-tête X-Request-Id, y compris les erreurs et les réponses 429. C’est toujours un UUID, et le request_id d’une erreur contient la même valeur.

Pour corréler les requêtes de bout en bout, envoyez votre propre UUID dans X-Request-Id : Tatallo renvoie un UUID bien formé tel quel. Toute autre valeur est remplacée par un UUID généré par Tatallo, de sorte que l’en-tête s’analyse toujours de la même façon.

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

Citez l’identifiant de requête chaque fois que vous contactez le support.