Limites de débit

Les limites s’appliquent par workspace et par X-Client-Name :

limites

Soutenu60 requêtes par minute

Rafalejusqu’à 20 requêtes en une seconde

Limite dépassée429 Too Many Requests avec un en-tête Retry-After

Bonnes pratiques

• Réessayez avec un backoff. Sur 429, attendez Retry-After secondes. Sur 5xx, réessayez les requêtes idempotentes (GET, PUT, DELETE) avec un backoff exponentiel et du jitter.
• Regroupez les écritures. POST .../scheduled-visits accepte une tournée entière en un seul appel : une requête pour 50 visites, et non 50 requêtes.
• Paginez avec la taille maximale (size=200) pour lire des collections complètes.
• Mettez en cache ce qui change rarement, comme les enseignes, les marques et les champs de questionnaire.
• Synchronisez de façon incrémentale avec since plutôt que de tout relire.

Méthodes HTTP

Méthodes HTTP

GETLecture

POSTCréation

PUTRemplacement (v1)

PATCHMet à jour uniquement les champs envoyés (v3)

DELETESuppression. N’accepte jamais de corps ; les ID vont dans le chemin ou la query string.