Referencia de la API

Límites de solicitudes y concurrencia

Name: SciFig
Author: SciFig

Límites de solicitudes, límites de tareas y cómo gestionar 429.

Límites#

Límite	Valor	Se aplica a
Solicitudes de creación	20 por minuto	Cada clave API o cada cliente OAuth y cuenta, en todos los puntos de acceso `POST`
Solicitudes de creación	40 por minuto	Cada cuenta, entre todas sus credenciales
Solicitudes de lectura	120 por minuto	Cada clave API o cada cliente OAuth y cuenta
Tareas en ejecución	Según el plan; consulta `GET /credits`	Cada cuenta, compartido con el sitio web
Tareas por hora	200 por hora móvil	Cada cuenta, compartido con el sitio web
Conversiones ráster	200 al día	Cada cuenta
Detecciones de texto	20 cada 15 minutos	Cada cuenta, compartido con el sitio web
Espera limitada	30 segundos	Cada solicitud

Las respuestas a solicitudes que superan la autenticación y la comprobación de ámbito incluyen X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para la ventana de solicitudes más restrictiva. 401 y 403 SCOPE_DENIED no los incluyen. Una respuesta 429 incluye Retry-After en segundos.
429 CONCURRENCY_LIMITED significa que ya hay demasiadas tareas en ejecución para la cuenta; las terminadas dejan de contar. Las causas de 429 RATE_LIMITED se enumeran más abajo.
Espera al menos Retry-After, aumenta el intervalo de forma exponencial con variación aleatoria y vuelve a intentarlo con el mismo Idempotency-Key.
Los límites de tareas corresponden a la cuenta: más claves no aumentan la capacidad.

Demasiadas solicitudes: 20 solicitudes de creación por minuto y credencial, 40 por cuenta y 120 lecturas por minuto y credencial. Retry-After indica el tiempo hasta que se reinicia la ventana; no hay details.reason.
Se han iniciado demasiadas tareas en la última hora: hasta 200 por cuenta, compartidas con el sitio web. Retry-After: 30.
Hay demasiadas tareas en ejecución: 429 CONCURRENCY_LIMITED, según el plan y compartidas con el sitio web; consulta GET /credits. Retry-After: 30.
Se ha agotado el cupo diario de 200 conversiones gratuitas a PNG, PDF, TIFF y PPTX: details.reason = DAILY_CONVERSION_LIMIT, con Retry-After hasta que se reinicia la ventana diaria.
Las subidas son demasiado rápidas: details.reason = UPLOAD_RATE_LIMITED para imágenes y máscaras en POST /files, archivos adjuntos de diagramas de flujo y datos de gráficos. Se aplica el límite de subidas por minuto del sitio web.
Demasiadas subidas en un día: details.reason = UPLOAD_DAILY_LIMIT_REACHED para archivos adjuntos de diagramas de flujo y datos de gráficos. Se aplica el límite diario de subidas del sitio web.
Detecciones de texto: 20 cada 15 minutos por cuenta, compartidas con el sitio web.