## 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 Requests` e 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](https://www.bulkgate.com/pt/documentacao/administracao-da-api/limites-api/) — controla o ritmo das
suas chamadas, não o volume que envia.

> [!IMPORTANT]
> 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

1. Clique em `Módulos e APIs` no menu do portal
2. Em `Minhas APIs e módulos`, clique no cartão da sua aplicação
3. Mantenha-se no separador `Definições` e desloque-se até à parte `Limites 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`.

![O cartão Limites de solicitação de API no detalhe da aplicação](docs:api-request-limits/request-limit-card_en)

## 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 janela com as definições do limite de pedidos](docs:api-request-limits/request-limit-settings_en)

A configuração obedece a duas regras:

- o valor mínimo aceite é `1` — caso contrário, o portal avisa com
  `Minimum 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.

> [!TIP]
> 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.