Limites de requisições
Engine ≥ 4.143.0. Cada resposta de token inclui data.rate_limits da política da loja no momento da emissão. Todas as chaves partilham estes limites; um novo token não os repõe. Uma alteração de plano pode aplicar-se antes de o token expirar.
- read_per_minute
- Pedidos de leitura por minuto.
- write_per_minute
- Pedidos de escrita por minuto; este valor não concede permissões de escrita.
- auth_per_minute
- Pedidos de token por minuto, incluindo tentativas de autenticação falhadas.
Distribua os pedidos uniformemente; com um limite de leitura positivo, deixe pelo menos 60 / read_per_minute segundos entre leituras. O limite não garante esse número de pedidos simultâneos. Outras integrações partilham-no: trate 429 e Retry-After.
Zero significa indisponível, não ilimitado.
Limites por minuto
| Disponível a partir de | Leitura · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- Escrita
- 10
- Autenticação
- 10
Todas as chaves da mesma loja partilham estes limites.
Pedido
- O tráfego de leitura e escrita está sujeito à política API atual da loja.
- As chaves não fornecem capacidade ilimitada independente.
- Limite a concorrência, armazene dados de referência em cache quando apropriado e evite buscar repetidamente detalhes que não mudaram.
429 · Retry-After
- Quando a API retornar 429 com rate_limit.exceeded, aguarde pelo menos os segundos indicados em Retry-After e acrescente uma variação aleatória antes de tentar novamente.
- 429 · capacity.queue_full — A fila curta da API está cheia; a execução do pedido não começou. 429 · capacity.wait_timeout — O tempo de espera na fila da API terminou; a execução do pedido não começou. Aguarde pelo menos os segundos de Retry-After e acrescente variação aleatória. Preserve a chave e o conteúdo originais ao repetir uma escrita.
- Use o código e o cabeçalho documentados em vez de presumir um intervalo fixo.