APIL'API Streamfizz applique des limites de débit pour garantir une utilisation équitable et protéger l'infrastructure.
| Endpoint | Limite | Fenêtre |
|---|---|---|
API GraphQL | 60 requêtes | par minute |
Upload | 5 requêtes | par minute |
Sans clé API | 10 requêtes | par minute, par adresse IP |
Les deux premières limites sont comptées par clé API, la dernière par adresse IP — elle couvre l'introspection du schéma, qui ne demande pas de clé. Contactez-nous si vous avez besoin de limites plus élevées.
Indépendamment du débit, chaque requête GraphQL doit tenir dans ces bornes. Au-delà, elle est refusée avant d'être exécutée.
| Limite | Valeur | Ce que ça borne |
|---|---|---|
| Profondeur | 10 | niveaux d'imbrication de la sélection |
| Coût | 5 000 | 2 par objet, 1 par scalaire, ×1,5 par niveau de profondeur |
| Alias | 15 | alias par requête |
| Directives | 50 | directives par requête |
| Jetons | 1 000 | longueur du document envoyé |
Cannot query field "x" on type "Y" sans proposer de correction.Lorsque vous dépassez la limite, l'API retourne une erreur 429 Too Many Requests.
API GraphQL
{
"error": "Too Many Requests",
"retryAfter": 42
}Upload
{
"success": false,
"code": "RATE_LIMITED",
"error": "Too Many Requests",
"retryAfter": 42
}data ni errors. Un client qui suppose l'enveloppe GraphQL échouera au parsing plutôt que de lire retryAfter.retryAfter pour implémenter une logique de retry avec backoff exponentiel.