Documentation Genesis API
Tout pour intégrer : authentification, limites, endpoints et schémas de réponse.
Plans et limites
Les limites dépendent de votre plan. L'état courant est toujours disponible sur /account/usage et dans les en-têtes de chaque réponse.
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| Appels par mois | 500K | 2M | 5M | 10M |
| Requêtes par seconde | 1 | 2 | 5 | 15 |
| Fraîcheur des données | 60 s | 30 s | 10 s | 5 s |
Les endpoints hors de votre plan renvoient 403 avec le code plan_restricted. Les requêtes au-delà des limites ne sont jamais facturées.
Seule une réponse 200 compte comme un appel. Les réponses 304 (non modifié) et les erreurs 4xx/5xx n'utilisent pas votre quota, mais elles comptent dans la limite de requêtes par seconde.
Le volume de téléchargement est limité à 60 Mo de données compressées par tranche de 10 secondes et par clé. Interroger chaque jeu de données à la fraîcheur de votre forfait tient largement dans la limite ; les réponses de moins de 64 Ko ne sont pas comptées. Au-delà de la limite : 429 download_limited jusqu'à la fin de la fenêtre, l'appel n'est pas décompté. Économisez du trafic avec If-None-Match, les filtres et le paramètre coin.
En-têtes de limites
| En-tête | Description | |
|---|---|---|
X-RateLimit-Limit | Limite de requêtes par seconde de votre plan | |
X-RateLimit-Remaining | Requêtes restantes dans la fenêtre courante | |
X-RateLimit-Reset | Temps unix de réinitialisation de la fenêtre | |
X-Quota-Limit | Quota d'appels pour la période courante de 30 jours | |
X-Quota-Remaining | Appels restants dans la période | |
X-Quota-Reset | Temps unix de réinitialisation du quota | |
Retry-After | Secondes à attendre avant de réessayer (429 et 503) |