Correio temporário para agentes de IA
Uma API de e-mail temporário sem cadastro que os agentes podem descobrir e usar de forma autônoma. Crie uma caixa de entrada, aguarde códigos de verificação, leia mensagens, obtenha seu código-fonte bruto e exclua mensagens usando HTTPS.
# Descubra domínios disponíveis:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Crie uma caixa de entrada de correio temporário privada. Sem inscrição, sem chave API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Aguarde um e-mail de verificação ou código OTP.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
-H 'Authorization: Inbox {token}' \
-H 'Content-Type: application/json' \
-d '{"codeOnly":true,"timeoutSeconds":60}'
# 3. Leia a mensagem completa.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
-H 'Authorization: Inbox {token}'{
"inbox": {
"address": "agent-lx84a9-q3mz2@reusable.email",
"domain": "reusable.email",
"created": true,
"type": "private",
"isProtected": true,
"retentionDays": 180
},
"password": "save-this-generated-password-securely",
"token": "use-this-as-an-inbox-token",
"tokenExpiresAt": "2026-06-09T18:30:00.000Z",
"links": {
"web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
"messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
"wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
}
}{
"status": "message",
"inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
"message": {
"id": 1842,
"from": { "name": "Example", "address": "login@example.com" },
"subject": "Your verification code",
"intro": "Use code 123456 to continue.",
"verificationCode": "123456"
}
}Interface para agentes
O manifesto de descoberta está disponível em /v1/agent-tempmail e espelhado em llms.txt para mecanismos de resposta.
| Método | Caminho | Uso |
|---|---|---|
| GET | /v1/agent-tempmail | Manifesto de descoberta para agentes e rastreadores |
| GET | /v1/agent-tempmail/domains | Listar domínios alternativos disponíveis |
| POST | /v1/agent-tempmail/inboxes | Crie uma caixa de entrada privada protegida por senha |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Listar mensagens recebidas |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Aguardar e-mails ou códigos com long polling |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Ler uma mensagem |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Obter a mensagem original no formato RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Excluir uma mensagem |
Fluxos de verificação
Use uma caixa de entrada de agente para e-mails de inscrição, login, redefinição de senha e confirmação de avaliação.
Automação do navegador
Combine-o com Playwright, Selenium ou um agente de navegação que precise de um endereço de e-mail real para entrega.
CI e QA
Crie caixas de entrada isoladas por execução de teste sem provisionar contas ou compartilhar credenciais.
Perguntas frequentes
Criar uma caixa de entrada privada é gratuito e não exige cadastro. Para escolher um domínio alternativo, informe um domínio obtido no endpoint da lista de domínios. A interface para agentes só recebe mensagens. Para volumes maiores ou envio de e-mails, use as APIs comuns vinculadas a uma conta.
Posso usar uma chave de acesso na caixa de entrada de um agente?+
Sim. Entre com a senha gerada e adicione uma chave de acesso nas configurações da caixa de entrada. O botão com ícone de chave no formulário de caixa privada e a tela de desbloqueio permitem entrar com uma chave de acesso. O token Inbox obtido funciona em todos os endpoints de caixa de entrada para agentes. As chaves de acesso exigem verificação interativa do usuário; guarde a senha para agentes que funcionam sem supervisão e renove tokens expirados com POST /v1/inbox/{address}/token e JSON {"password":"..."}.
Posso escolher um domínio alternativo?+
Sim. GET /v1/agent-tempmail/domains lista os domínios disponíveis. Informe domain junto com prefix ou com um address que contenha apenas a parte anterior ao @, ou forneça um address completo. Endereços existentes ou reservados não podem ser registrados.
Um agente de IA pode usar isso sem inscrição?+
Sim. O agente pode criar uma caixa de entrada com uma solicitação POST não autenticada. A resposta inclui uma senha gerada e um token da caixa de entrada. Todas as caixas de entrada criadas são privadas. Salve a senha para login normal na caixa de entrada privada após o token expirar.
É necessário usar MCP, um SDK ou fazer alguma instalação?+
Não. A interface é totalmente acessível via HTTPS e curl. Os agentes podem descobri-la por meio do llms.txt ou do manifesto JSON em /v1/agent-tempmail.
Os agentes podem enviar e-mails por esta API?+
Não. A interface para agentes sem cadastro permite apenas receber, ler, aguardar, obter o código-fonte e excluir mensagens. O envio de e-mails é intencionalmente excluído dessa interface pública.
Como os códigos de verificação são disponibilizados?+
As respostas de lista de mensagens, espera e detalhes priorizam cabeçalhos experimentais OTP-Token válidos e, na ausência deles, procuram códigos no texto. Os códigos obtidos de cabeçalhos incluem verificationCodeOrigin: antes de enviar o código, verifique se o esquema, o host e a porta correspondem exatamente à origem do destino pretendido. Esse valor é fornecido pelo remetente e não comprova sua identidade. Nunca acesse automaticamente um endereço fornecido pelo remetente.
Por quanto tempo as caixas de entrada criadas por agentes são mantidas?+
As caixas de entrada criadas por agentes têm recursos normais de caixa de entrada privada e retenção de mensagens por 180 dias.