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 compartilham esses limites; um novo token não os reinicia. Uma mudança de plano pode valer antes de o token expirar.
- read_per_minute
- Solicitações de leitura por minuto.
- write_per_minute
- Solicitações de escrita por minuto; este valor não concede permissões de escrita.
- auth_per_minute
- Solicitações de token por minuto, incluindo tentativas de autenticação malsucedidas.
Distribua as solicitações uniformemente; com um limite de leitura positivo, aguarde pelo menos 60 / read_per_minute segundos entre leituras. O limite não garante essa quantidade de solicitações simultâneas. Outras integrações o compartilham: 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 compartilham esses limites.
Requisição
- 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 da solicitação não começou. 429 · capacity.wait_timeout — O tempo de espera na fila da API acabou; a execução da solicitação 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.