Límites de frecuencia de la API

Cubo de tokens por clave

Cada clave de API tiene un bucket de tokens con una ráfaga de 60 tokens y una tasa de recarga de 1 token por segundo. Las lecturas cuestan 1 token. Las escrituras cuestan 2 tokens.

Crear una notificación de actualización de producto (POST /products/{shopify_product_id}/notifications, dry run incluido) cuesta 10 tokens. El indicador notify_customers en una escritura de asignación no añade nada: esa escritura cuesta sus 2 tokens habituales, pida o no una notificación. El límite de 7 días de una notificación por producto es una regla aparte con su propio código, 429 notification_cooldown: su Retry-After puede llegar a siete días, así que no lo reintentes automáticamente — programa la siguiente llamada en error.details.next_available_at.

Además, una tienda puede tener como máximo 5 notificaciones de actualización de producto en cola o enviándose a la vez. Una sexta es 429 too_many_active_notifications, un tercer tipo de 429 junto a rate_limited y notification_cooldown, así que distínguelos por error.code, no por el código de estado. No tiene Retry-After: consulta periódicamente GET /notifications/{id} de una de las error.details.active_notification_ids y reintenta cuando esa campaña haya terminado.

Cuando se supera el límite, la API devuelve 429 rate_limited.

Cabeceras de límite de frecuencia

Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2026-06-05T12:00:00.000Z

Espera al menos la duración indicada en Retry-After antes de reintentar. Reutiliza la misma Idempotency-Key al reintentar la misma escritura.

Límite de reenvío de emails

El endpoint de reenvío de pedidos tiene un límite de seguridad adicional por pedido de 3 solicitudes de reenvío por hora.