PrevenAPILimites et quotas
Requêtes par minute
| Plan | Requêtes / minute | Déclarations / mois |
|---|---|---|
| Free | 30 | 100 |
| Starter | 60 | 2 000 |
| Pro | 300 | 10 000 |
| Business | 600 | 50 000 |
La limite s'applique par clé et par organisation. Chaque réponse porte X-RateLimit-Limit et X-RateLimit-Remaining. Au-delà : 429 RATE_LIMIT_EXCEEDED avec Retry-After en secondes.
Ce qui est compté
Une unité = un titulaire (une ligne de fichier).
| Endpoint | Clé live | Clé test |
|---|---|---|
POST /v1/declarations/validate |
gratuit | gratuit |
POST /v1/files/generate |
1 unité par titulaire, seulement si le fichier est produit | gratuit |
POST /v1/files/validate |
1 unité par ligne | gratuit |
| Tout le reste | gratuit | gratuit |
Le compteur repart à zéro le 1er du mois (UTC). Quota atteint : 429 QUOTA_EXCEEDED, avec used, limit et requested dans details. La requête est refusée en entier : il n'y a pas de dépassement facturé.
Utilisez Idempotency-Key sur generate pour qu'une nouvelle tentative après une coupure réseau ne soit pas comptée deux fois.
Tailles
| Limite | |
|---|---|
Fichier envoyé à /v1/files/validate |
20 Mo |
| Corps JSON | 20 Mo |
| Lignes par requête | 50 000 (50 avec une clé de test) |
| Titulaires par déclaration | 500 (règle officielle) |
Le portail officiel accepte jusqu'à 200 Mo. Pour un très gros dépôt, découpez en plusieurs fichiers.