Référence API

Limites de requêtes et de simultanéité

Name: SciFig
Author: SciFig

Limites des requêtes, limites des tâches et traitement des réponses 429.

Limites#

Limite	Valeur	S’applique à
Requêtes de création	20 par minute	Chaque clé API, ou chaque client OAuth et compte, sur tous les points d’accès `POST`
Requêtes de création	40 par minute	Chaque compte, sur l’ensemble de ses identifiants
Requêtes de lecture	120 par minute	Chaque clé API, ou chaque client OAuth et compte
Tâches en cours	Selon l’offre ; voir `GET /credits`	Chaque compte, quota partagé avec le site
Tâches par heure	200 par heure glissante	Chaque compte, quota partagé avec le site
Conversions matricielles	200 par jour	Chaque compte
Détections de texte	20 toutes les 15 minutes	Chaque compte, quota partagé avec le site
Attente limitée	30 secondes	Chaque requête

Les réponses aux requêtes ayant passé l’authentification et la vérification de portée contiennent X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset pour la fenêtre de requêtes la plus restrictive. 401 et 403 SCOPE_DENIED n’en contiennent pas. Une réponse 429 contient Retry-After en secondes.
429 CONCURRENCY_LIMITED signifie que trop de tâches sont déjà en cours pour le compte ; les tâches terminées ne comptent plus. Les causes de 429 RATE_LIMITED sont répertoriées ci-dessous.
Attendez au moins Retry-After, augmentez exponentiellement le délai avec une variation aléatoire et réessayez avec le même Idempotency-Key.
Les limites de tâches s’appliquent au compte : ajouter des clés n’augmente pas la capacité.

Trop de requêtes : 20 requêtes de création par minute et par identifiant, 40 par compte, 120 lectures par minute et par identifiant. Retry-After indique le délai avant la réinitialisation de la fenêtre ; details.reason est absent.
Trop de tâches ont démarré au cours de la dernière heure : jusqu’à 200 par compte, quota partagé avec le site. Retry-After: 30.
Trop de tâches sont en cours : 429 CONCURRENCY_LIMITED, selon l’offre et quota partagé avec le site ; voir GET /credits. Retry-After: 30.
Le quota quotidien de 200 conversions gratuites PNG, PDF, TIFF et PPTX est épuisé : details.reason = DAILY_CONVERSION_LIMIT, avec Retry-After jusqu’à la réinitialisation de la fenêtre quotidienne.
Les importations sont trop rapides : details.reason = UPLOAD_RATE_LIMITED pour les images et masques sur POST /files, les pièces jointes de diagrammes de flux et les données de graphiques. La limite d’importation par minute du site s’applique.
Trop d’importations dans la journée : details.reason = UPLOAD_DAILY_LIMIT_REACHED pour les pièces jointes de diagrammes de flux et les données de graphiques. La limite quotidienne d’importation du site s’applique.
Détections de texte : 20 par période de 15 minutes et par compte, quota partagé avec le site.