Limites da API

Para que servem os limites de mensagens

Um limite de mensagens controla quantas mensagens uma única aplicação pode enviar por dia. O portal descreve-o como um mecanismo para definir e monitorizar os limites de mensagens de uma API e indica ele próprio o motivo: manter a utilização da API sob controlo, para que não surjam custos financeiros indesejados e ninguém utilize o canal de forma abusiva.

O limite pode ser repartido por país e, além disso, decide o que acontece às mensagens acima do limite — se ficam à espera, se são enviadas no dia seguinte ou se são descartadas.

Onde encontrar os limites

1. No menu do portal, clique em Módulos e APIs
2. Em Minhas APIs e módulos, clique no cartão da sua aplicação
3. Mantenha-se no separador Definições e desça até à parte Limites de API

O cartão Limites de mensagens da API mostra a configuração atual em três linhas — Máximo de mensagens de API por dia, Limite de mensagens por país e Ações acima do limite. Enquanto não estiver nada definido, mostra em vez disso Você não tem configurações. e o botão Configurar.

Como definir os limites

O botão Configurar (ou Editar, se já tiver limites) abre a janela Limites de mensagens da API com três passos. Navega entre eles com os botões Próximo e De volta; nada é guardado até ao Salve final.

Passo 1 — Máximo de mensagens de API por dia

Introduza quantas mensagens a aplicação pode enviar num único dia. Sem um número positivo, o botão Próximo permanece desativado.

Passo 2 — Limite de mensagens por país

Deixe Sem limite ou escolha Defina o limite personalizado para um país específico e, no campo País de pesquisa, selecione os países que pretende tratar separadamente. Cada país é adicionado a uma lista, onde lhe atribui um de três modos:

Assim que a lista tiver mais do que uma entrada, aparece a linha Outros países, que define o modo para todos os restantes países de uma só vez. O ícone do caixote do lixo remove um país da lista.

Passo 3 — Ações acima do limite

O portal pergunta O que fazer com mensagens que ultrapassam o limite? e oferece três opções:

Como acompanhar a utilização do limite

Por cima dos separadores Definições e Estatisticas encontra-se o painel Status atual dos limites da API, com a percentagem utilizada e uma barra de progresso. Se repartir o limite por país, é acrescentada uma linha para cada um deles; um país bloqueado mostra negado em vez da barra.

Aos 80 %, o portal avisa com Your daily limit will soon be exceeded. e, quando o limite estiver totalmente esgotado, com Você atingiu seu limite diário de API!.

O botão Redefinir limite repõe a zero o contador das mensagens de hoje — a janela de confirmação indica que O contador de mensagens enviadas hoje será zerado. O ícone ao lado da linha de um país repõe apenas esse país. Enquanto a aplicação não tiver enviado nada hoje, o botão permanece desativado.

Avisos sobre tráfego invulgar

Além dos limites que define, o portal acompanha também a evolução do tráfego da sua aplicação ao longo do tempo. Compara as mensagens de hoje com o que a aplicação enviava no período anterior e avisa-o quando os dois valores divergem de forma significativa.

Distingue dois casos:

O primeiro caso funciona, portanto, também como salvaguarda — as mensagens aguardam até as aprovar, independentemente da ação acima do limite que tiver definido.

Para não o inundar de avisos, o portal envia apenas alguns avisos sobre o mesmo fenómeno e depois deixa de avisar. Também precisa de um histórico de envios — numa aplicação recém-criada, sem nada com que comparar, as tendências não são avaliadas.

Como remover os limites

A seta ao lado do botão Editar abre um menu com a opção Excluir. A janela de confirmação Remover limites da API indica que, depois de eliminados, a API deixará de restringir o envio de mensagens de acordo com os limites.