L'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 |
Introspection | 120 requêtes | par minute |
Sans clé API | 10 requêtes | par minute, par adresse IP |
Les trois premières limites sont comptées par clé API, la dernière par adresse IP. L'introspection du schéma demande une clé valide, comme toute requête : une requête qui ne contient que des champs d'introspection (__schema, __type) est comptée à part et n'entame pas les 60 requêtes de la clé. Contactez-nous si vous avez besoin de limites plus élevées.
Chaque réponse de l'API GraphQL et de l'upload porte l'état du quota qui a compté la requête. Les en-têtes sont lisibles depuis un navigateur (CORS) sur l'API GraphQL.
| En-tête | Valeur |
|---|---|
| RateLimit-Limit | nombre de requêtes de la fenêtre |
| RateLimit-Remaining | requêtes restantes dans la fenêtre courante (0 sur un 429) |
| RateLimit-Reset | secondes avant la réinitialisation de la fenêtre |
| Retry-After | sur un 429 seulement : secondes à attendre avant de réessayer |
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 de champs imbriqués, fragments dépliés (un fragment ne compte pas comme un niveau) |
| 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é |
Un document qui dépasse 1 000 jetons est refusé dès l'analyse syntaxique : la réponse porte un code HTTP 400 et l'erreur le code GRAPHQL_PARSE_FAILED.
Les autres limites sont contrôlées à la validation du document : la réponse porte un code HTTP 400, l'erreur le code GRAPHQL_VALIDATION_FAILED et un message qui donne la limite et la valeur mesurée, par exemple Query depth limit of 10 exceeded, found 12. Le coût mesuré est arrondi à l'entier supérieur.
Une requête HTTP porte une seule opération : l'envoi d'un tableau d'opérations (batching) est désactivé et renvoie un code HTTP 400, avec le code BAD_REQUEST et le message Operation batching disabled.
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.Retry-After (ou le champ retryAfter, de même valeur) pour implémenter une logique de retry avec backoff exponentiel, et RateLimit-Remaining pour ralentir avant d'atteindre la limite.