Límites de solicitudes
Engine ≥ 4.143.0. Cada respuesta de token incluye data.rate_limits de la política de la tienda vigente al emitirlo. Todas las claves comparten estos presupuestos; un token nuevo no los reinicia. Un cambio de plan puede aplicarse antes de que caduque el token.
- read_per_minute
- Solicitudes de lectura por minuto.
- write_per_minute
- Solicitudes de escritura por minuto; este valor no concede permisos de escritura.
- auth_per_minute
- Solicitudes de token por minuto, incluidos los intentos de autenticación fallidos.
Distribuye las solicitudes de forma uniforme; con un límite de lectura positivo, deja al menos 60 / read_per_minute segundos entre lecturas. El límite no garantiza esa cantidad de solicitudes simultáneas. Otras integraciones lo comparten: gestiona 429 y Retry-After.
Cero significa no disponible, no ilimitado.
Límites por minuto
| Disponible desde | Lectura · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- Escritura
- 10
- Autenticación
- 10
Todas las claves de una misma tienda comparten estos límites.
Solicitud
- El tráfico de lectura y escritura está sujeto a la política API actual de la tienda.
- Las claves no proporcionan capacidad ilimitada independiente.
- Limita la concurrencia, almacena en caché los datos de referencia cuando proceda y evita consultar repetidamente detalles que no han cambiado.
429 · Retry-After
- Si la API devuelve 429 con rate_limit.exceeded, espera al menos los segundos indicados en Retry-After y añade una variación aleatoria antes de reintentar.
- 429 · capacity.queue_full — La cola breve de la API está llena; la solicitud no ha comenzado a ejecutarse. 429 · capacity.wait_timeout — Se agotó el tiempo de espera en la cola de la API; la solicitud no ha comenzado a ejecutarse. Espera al menos los segundos indicados por Retry-After y añade una variación aleatoria. Conserva la clave y el contenido originales al reintentar una escritura.
- Utiliza el código y la cabecera documentados en lugar de suponer un intervalo fijo.