Bonnes pratiques

Ce qui fait durer une intégration.

• Utilisez le mode incrémental (desde + depoisDe) pour synchroniser : il n'apporte que ce qui a changé et n'atteint pas la limite.
• Gérez le 429 en attendant le Retry-After, avec recul exponentiel — ne réessayez jamais en boucle serrée.
• Envoyez Idempotency-Key sur chaque POST : le réseau tombe, votre routine répète, rien ne se duplique.
• Vérifiez la signature du webhook avant de traiter ; répondez 2xx vite et traitez ensuite.
• Une clé par système intégré, avec la plus petite portée qui convient ; révoquez ce qui ne sert pas.

Formes inadéquates

• Balayer toute la liste chaque minute — c'est ce que le mode incrémental remplace.
• Partager la clé d'API avec des utilisateurs finaux ou l'embarquer dans une app mobile ou une page publique.
• Écrire via l'API sans utilisateur responsable sur la clé — la trace n'aurait pas d'auteur, d'où le 409.