Limites de débit
Obtenir une clé APISofia API compte les requêtes sur trois fenêtres : 15 minutes, 24 heures et 30 jours.
| Jeton | 15 minutes | 24 heures | 30 jours |
|---|---|---|---|
| Clé personnelle (par compte) | 150 | 1 000 | 10 000 |
| Client OAuth | 100 | 500 | 15 000 |
| Client OAuth, par personne autorisée (jusqu’à 1 000) | +10 | +25 | +100 |
En-têtes
Chaque réponse vous dit ce qu’il reste, au format IETF :
RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000r est le nombre de requêtes restantes, t les secondes avant la réinitialisation de la fenêtre, q le quota et w la fenêtre en secondes.
Quand une fenêtre est pleine
La réponse est 429 rate_limit_exceeded, avec un en-tête Retry-After et la fenêtre épuisée dans details. Attendez ce délai avant de réessayer.
Utiliser l’API efficacement
- Enregistrez un webhook plutôt que d’interroger une publication en boucle.
- Utilisez
limitjusqu’à 100 pour lire les listes en moins de pages. - Mettez en cache ce qui change rarement : plateformes, établissements, comptes connectés.