Limites de pedidos da API
O que o limite de pedidos restringe
O limite de pedidos controla a frequência com que a sua aplicação pode chamar a API — ou seja, o número de pedidos, não o número de mensagens enviadas. O próprio portal o indica nas definições:
Definir esse limite restringe o número de solicitações de API, não o número de mensagens enviadas. Quando o limite é atingido, a API retorna o código HTTP
429 Too Many Requestse as mensagens não são aceitas.
Um único pedido pode transportar centenas de mensagens, pelo que este limite protege algo diferente dos limites de mensagens da API — controla o ritmo das suas chamadas, não o volume que envia.
Quando o limite se esgota, a API rejeita o pedido inteiro. As mensagens nele contidas não são guardadas em lado nenhum nem enviadas mais tarde — ao contrário do limite de mensagens, em que as mensagens acima do limite são tratadas pela ação definida para a ultrapassagem do limite.
Onde encontrar o limite
- Clique em
Módulos e APIsno menu do portal - Em
Minhas APIs e módulos, clique no cartão da sua aplicação - Mantenha-se no separador
Definiçõese desloque-se até à parteLimites de API
O cartão Limites de solicitação de API mostra os valores em duas linhas — Máximo de solicitações por minuto e Máximo de solicitações por segundo. Enquanto nada estiver definido, mostra
Você não tem configurações. e um botão Configurar.
Como definir o limite
O botão Configurar (ou Editar, se já tiver um limite) abre a janela Limites de solicitação de API com duas opções independentes:
| Opção | O que define |
|---|---|
Ativar Limite de Solicitação de API por Minuto |
Quantos pedidos a aplicação pode enviar num minuto |
Ativar limite de solicitação de API por segundo |
Quantos pedidos a aplicação pode enviar num segundo |
Ao marcar uma opção, surge o campo Insira o número de solicitações. Pode ativar
qualquer uma delas ou ambas em simultâneo.
A configuração obedece a duas regras:
- o valor mínimo aceite é
1— caso contrário, o portal avisa comMinimum value is 1 - se ativar ambas as opções, o limite por segundo não pode ser superior ao limite
por minuto; caso contrário, obtém
O valor não deve exceder as solicitações por minuto
O botão Salve permanece desativado até que ambas as regras sejam cumpridas — e também até
que altere os valores em relação aos que já estão guardados.
Como é contado o limite
O contador está associado ao segundo e ao minuto do calendário, não a uma janela deslizante. No momento em que começa um novo segundo (um novo minuto, no caso do limite por minuto), o contador recomeça do zero.
O limite por segundo é útil para suavizar picos; o limite por minuto, para o ritmo global. Quando define ambos, aplicam-se em conjunto — um pedido só passa quando cabe dentro de ambos.
Como remover o limite
A seta junto ao botão Editar abre um menu com a opção Excluir. A
janela de confirmação Excluir limites de solicitação de API pergunta Tem certeza de que deseja excluir os limites de solicitação da API? — depois de confirmar, a API deixa de restringir o
ritmo das suas chamadas.
Obrigado pelo seu feedback.