Limites de taxa da API

Token bucket por chave

Cada chave de API tem um token bucket com uma rajada de 60 tokens e uma taxa de reabastecimento de 1 token por segundo. As leituras custam 1 token. As gravações custam 2 tokens.

Criar uma notificação de atualização de produto (POST /products/{shopify_product_id}/notifications, dry run incluído) custa 10 tokens. O sinalizador notify_customers em uma gravação de mapeamento não acrescenta nada: essa gravação custa os 2 tokens de sempre, peça ela uma notificação ou não. O limite de 7 dias de uma notificação por produto é uma regra separada, com código próprio, 429 notification_cooldown: seu Retry-After pode chegar a sete dias, então não tente de novo automaticamente — agende a próxima chamada para error.details.next_available_at.

Uma loja também pode ter no máximo 5 notificações de atualização de produto na fila ou enviando ao mesmo tempo. A sexta notificação é 429 too_many_active_notifications, um terceiro tipo de 429 ao lado de rate_limited e notification_cooldown, então diferencie-os por error.code, não pelo status. Essa resposta não tem Retry-After: consulte periodicamente GET /notifications/{id} de um dos error.details.active_notification_ids e tente de novo quando essa campanha terminar.

Quando o limite é excedido, a API retorna 429 rate_limited.

Cabeçalhos de limite de taxa

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

Aguarde pelo menos a duração indicada em Retry-After antes de tentar novamente. Reutilize a mesma Idempotency-Key ao repetir a mesma gravação.

Limite de reenvio de e-mail

O endpoint de reenvio de pedidos tem um limite de segurança adicional por pedido de 3 solicitações de reenvio por hora.