Bonnes pratiques et limites

Utiliser l'API de façon fiable.

Écrit par Louis

Dernière mise à jour Il y a environ 13 heures

Quelques règles simples pour des intégrations fiables, rapides et sûres.

Bonnes pratiques

Filtrez et paginez : ne récupérez que les données utiles.
Mettez en cache ce qui change peu (référentiels) pour limiter les appels.
Gérez les erreurs : anticipez les réponses d'erreur et les limites de débit.
Protégez vos jetons : traitez-les comme des secrets, révoquez au moindre doute.

Limites à connaître

Sujet	À retenir
Périmètre	La version un est en lecture ; les écritures ne sont pas encore ouvertes.
Débit	100 requêtes par minute, comptées par adresse d'origine des appels - pas par jeton ni par cabinet.
Routes spécifiques	Recherche d'entreprise et contrôle de numéro de TVA intracommunautaire : 20 requêtes/minute. Suggestion de régime de TVA : 60 requêtes/minute - ces routes s'appuient sur des services publics eux-mêmes limités.
Isolation	Un accès ne dépasse jamais le périmètre de son cabinet et de ses droits.

⚠️ Important : Au-delà de la limite, l'API répond 429 : temporisez jusqu'à la minute suivante plutôt que de relancer immédiatement.

ℹ️ Le compteur est partagé par adresse d'origine : deux intégrations qui sortent par la même adresse consomment aujourd'hui le même quota. Un budget propre à chaque cabinet est prévu.

Pour aller plus loin

Besoin d'aide supplémentaire ? Demander à l'équipe