A ativação por e-mail via API é necessária quando o cadastro é confirmado pelo e-mail, e não pelo telefone: clientes de e-mail, contas de anúncios sem verificação por telefone, fóruns e serviços em que o código ou o link chega exclusivamente por mensagem de e-mail. Vamos ver como funciona o ciclo de solicitação de uma caixa de e-mail para ativação, o que significam os códigos de resposta mais comuns e como consultar o status sem estourar o limite de requisições.

Ciclo de vida da ativação por e-mail: da solicitação ao código

O ciclo tem quatro etapas. Primeiro, o cliente solicita uma caixa de e-mail para um site específico: nos parâmetros da requisição você informa o serviço para o qual precisa do cadastro. O sistema reserva um endereço livre e devolve o identificador da ativação: a partir desse momento, a caixa fica vinculada ao pedido e não é entregue a outro cliente ao mesmo tempo. A segunda etapa é a espera pela mensagem: o site de destino envia a confirmação para o endereço fornecido, e isso pode levar de alguns segundos a alguns minutos, dependendo da velocidade do remetente. A terceira etapa é a obtenção do código: assim que a mensagem é entregue, a API devolve o código ou o link do e-mail, conforme o formato de confirmação daquele site. A quarta etapa é a conclusão da ativação, se o código funcionou, ou o cancelamento, se o cadastro não deu certo e a caixa precisa ser liberada antes do prazo, sem esperar o vencimento.

Por que a caixa só recebe mensagens dos sites informados

Ao pedir uma ativação por e-mail, você informa o site ou a lista de sites para os quais a caixa deve receber mensagens. Isso não é uma limitação técnica, e sim um filtro deliberado por remetente: mensagens de origens fora da lista não são processadas e não são entregues pela API. Há dois motivos. Primeiro, uma mesma caixa física pode atender pedidos de serviços diferentes ao mesmo tempo, sem risco de misturar as mensagens entre clientes. Segundo, o filtro protege contra newsletters e e-mails de phishing, que de outra forma entupiriam a fila de entrada e deixariam o processamento da correspondência mais lento. Se o site em que você está se cadastrando não consta na lista informada no pedido, a mensagem simplesmente não aparece na resposta da API — essa é a primeira coisa a verificar quando o código demora a chegar.

Códigos de resposta mais comuns e o que significam na prática

O código «sem caixas disponíveis» significa que o conjunto de endereços para aquele site está temporariamente esgotado: vale esperar e repetir a requisição em um ou dois minutos ou, se o serviço permitir, fazer o pedido para um site vizinho da mesma família. O código «mensagem ainda não chegou» é um estado intermediário normal, e não um erro: a ativação foi criada, a caixa aguarda a mensagem, e uma nova consulta depois de um intervalo razoável vai, mais cedo ou mais tarde, devolver o código pronto. O código «ativação expirada» aparece quando a mensagem não chegou dentro do tempo estabelecido: o limite existe para que as caixas não fiquem paradas indefinidamente em pedidos esquecidos, e, depois do vencimento, o endereço volta ao conjunto geral. O código «cancelamento registrado» confirma que a ativação foi encerrada antecipadamente por você mesmo — a diferença fundamental em relação à expiração é que a iniciativa partiu do cliente, e não do tempo limite do sistema. Se o conjunto ficar vazio por mais tempo do que o normal, perguntar ao suporte por meio de um tíquete se há reposição prevista para o site desejado costuma ser mais rápido do que repetir requisições manualmente.

Como consultar o status sem gerar carga desnecessária

Uma forma comum de quebrar a integração é consultar o status da ativação em loop, sem pausa, várias vezes por segundo. Isso não acelera a entrega da mensagem: a velocidade depende de quão rápido o site remetente monta e envia o e-mail, e não da frequência com que você chama a API. Um intervalo razoável é uma consulta a cada poucos segundos, aumentando gradualmente a pausa se o status demorar a mudar. Esse modo respeita o limite de requisições, não cria uma fila de chamadas idênticas e não muda a velocidade final para receber o código em comparação com a consulta intensa — a diferença aparece apenas na quantidade de requisições gastas. O mesmo princípio vale para outras APIs do catálogo, por exemplo na configuração de rotação de IP via API: consultar com muita frequência não acelera o resultado, só consome o limite.

Ativação por e-mail versus ativação por SMS na automação

Em um cenário de cadastro em massa, e-mail e SMS resolvem tarefas diferentes e costumam ser usados juntos. A ativação por SMS está ligada a um número de telefone: o código chega a uma linha virtual específica, disponível durante a ativação, e o custo depende do país e do serviço — as opções atuais estão reunidas na seção de recebimento de SMS. A ativação por e-mail está ligada a uma caixa de correio, que pode receber várias mensagens de um ou mais sites informados durante o período de aluguel, e esse modelo é mais útil quando a confirmação chega com atraso, exige clicar em um link em vez de digitar um código curto, ou quando o serviço nem pede telefone. Uma abordagem de estrutura parecida é usada em outras APIs do catálogo — por exemplo, no ciclo de emissão e renovação de canais de proxy via API: pedir, usar, renovar ou abrir mão do recurso sem intervenção manual. Ao projetar a automação de cadastros, vale prever os dois canais em paralelo: eles se complementam, e a escolha depende do que cada site realmente exige.

Perguntas frequentes

É possível usar uma mesma caixa para vários sites ao mesmo tempo?

Sim, se no pedido você informou vários sites na lista de remetentes permitidos — a caixa receberá mensagens de cada um deles dentro de um único aluguel, sem precisar pedir um endereço separado para cada serviço.

O que fazer se o código chegou, mas não funcionou no site?

Primeiro verifique se o código não expirou no próprio site — muitos serviços têm um prazo de validade curto para o código, independentemente da API. Se o código está válido e mesmo assim não é aceito, é provável que a mensagem tenha sido duplicada a partir de outro endereço ou que o site use um formato fora do padrão — vale conferir a mensagem inteira, e não só um trecho recortado.

Como saber se as requisições à API estão sendo enviadas com frequência demais?

O sinal são códigos de limite de frequência de requisições no lugar do status esperado da ativação. Se isso acontece com regularidade, aumente o intervalo entre as consultas, principalmente na etapa de espera pela mensagem, quando o estado objetivamente não pode mudar mais rápido do que o site remetente leva para montar o e-mail.

A descrição completa dos métodos, dos parâmetros da solicitação de caixa e da conclusão da ativação está na documentação técnica da API.