E-mail temporário por API, num servidor de correio próprio

Trava a chave no IP de onde a chamada partiu (ou nos IPs/CIDRs que você mandar no corpo). Enquanto a chave não tiver nenhum IP liberado, as rotas /v1/* respondem 403 “Chave não ativada”.

• Rode a partir do servidor / VPS que vai consumir a API — ele detecta o IP sozinho.
• Até 3 IPs liberados ao mesmo tempo. Até 5 trocas por mês.
• Toda ativação fica registrada. Uso da chave a partir de IP não liberado gera alerta.

curl -s -X POST https://api.impulsionantegroup.online/v1/activate \
  -H "X-API-Key: tmk_live_SUA_CHAVE"

curl -s -X POST https://api.impulsionantegroup.online/v1/activate \
  -H "X-API-Key: tmk_live_SUA_CHAVE" \
  -H "content-type: application/json" \
  -d '{"ips": ["203.0.113.10", "198.51.100.0/29"]}'

{
  "ip_allowlist": ["203.0.113.10"],
  "changed": true,
  "activations_used": 1,
  "activations_limit": 5
}

App atrás de proxy rotativo

Se cada request sua sai de um IP diferente (pool de proxy), a trava por IP não serve. Ligue o modo proxy — a trava por IP sai e, no lugar dela, toda request passa a exigir o header X-Client-Instance (um id fixo por worker/instância da sua aplicação, ex.: gen-worker-03).

curl -s -X POST https://api.impulsionantegroup.online/v1/activate \
  -H "X-API-Key: tmk_live_SUA_CHAVE" \
  -H "content-type: application/json" -d '{"mode": "proxy"}'

# depois disso, TODA chamada precisa do header:
curl -s -X POST https://api.impulsionantegroup.online/v1/mailboxes \
  -H "X-API-Key: tmk_live_SUA_CHAVE" \
  -H "X-Client-Instance: gen-worker-03"

Voltar pra trava por IP: {"mode": "strict"}. A troca de modo também conta no limite mensal e fica registrada. Modo proxy é monitorado por volume e por número de instâncias distintas.

Domínios liberados para a sua chave. Use um deles no campo domain ao criar, ou deixe a API sortear.

{
  "domains": ["impulsionantegroup.online", "impulsionantegroup.shop"]
}

Provisiona uma caixa nova. Corpo JSON — todos os campos são opcionais.

curl -s -X POST https://api.impulsionantegroup.online/v1/mailboxes \
  -H "X-API-Key: tmk_live_SUA_CHAVE" \
  -H "content-type: application/json" \
  -d '{"domain": "impulsionantegroup.shop"}'

{
  "token": "8H4JSMrsuxzJbTjiEDO7lD9NEKrNBaju",
  "email": "p8ezpb2cte@impulsionantegroup.shop",
  "domain": "impulsionantegroup.shop",
  "created_at": "2026-09-06T01:28:06Z",
  "expires_at": "2026-09-13T01:28:06Z",
  "expires_in_seconds": 604800,
  "password": "pEODv@6CH3wnVZ#zftc5",
  "webmail_url": "https://webmail.impulsionantegroup.online"
}

Metadados e quanto falta para expirar. Devolve o mesmo formato do POST. 410 quando a caixa já expirou.

Lê INBOX + Junk via IMAP, mais recentes primeiro. Parâmetro ?limit= (1–100, padrão 25).

{
  "email": "p8ezpb2cte@impulsionantegroup.shop",
  "count": 1,
  "messages": [
    {
      "id": "INBOX:1",
      "from_addr": "noreply@discord.com",
      "from_name": "",
      "to": "p8ezpb2cte@impulsionantegroup.shop",
      "subject": "Verify Email Address for Discord",
      "date": "2026-09-06T01:28:10Z",
      "seen": false,
      "preview": "Click https://click.discord.com/… to verify"
    }
  ]
}

Use o id ("INBOX:1") para abrir a mensagem inteira.

A mensagem completa. Além dos campos da lista, inclui:

{
  "id": "INBOX:1",
  "subject": "Verify Email Address for Discord",
  "text": "Click the link below…",
  "html": "<html>…</html>",
  "links": ["https://click.discord.com/ls/click?upn=…"],
  "attachments": []
}

Duas formas de trazer a caixa de volta depois dos 7 dias:

• Pelo webmail (automático): o usuário final entra em webmail.impulsionantegroup.online com o e-mail + senha. Se a caixa expirou, aparece o botão Reativar minha caixa — recria o mesmo endereço na hora, vazio. Não precisa de nenhuma chamada à API.
• Por esta rota: chame quando o cliente renovar o acesso.
  • Caixa ativa → estende a validade por mais 7 dias. Resposta com "recreated": false.
  • Caixa expirada → recria o mesmo endereço, com a mesma senha, caixa vazia. Resposta com "recreated": true e o password. Conta como uma criação na sua cota.

curl -s -X POST https://api.impulsionantegroup.online/v1/mailboxes/$TOKEN/renew \
  -H "X-API-Key: tmk_live_SUA_CHAVE"

Remove o mailbox do servidor na hora, antes dos 7 dias. Responde 204 sem corpo. Opcional — a caixa some sozinha no vencimento.

Consulta o próprio plano, validade e uso do mês.

{
  "id": "cli_87b1acd07373",
  "plan": "basic",
  "active": true,
  "expired": false,
  "expires_at": "2026-10-06T00:00:00Z",
  "limits": { "rate_per_min": 60, "monthly_quota": 20000 },
  "usage":  { "period": "2026-09", "requests": 1240, "mailboxes": 310 }
}