Developers

Construa com a API do ChatTempMail

E-mail temporário com superpoderes de IA — API REST, especificação OpenAPI 3.1, servidor MCP, agent skill e webhooks. Chave de API e caixa descartável em menos de um minuto.

Início rápido

Três chamadas até seu primeiro código de verificação. URL base: https://chat-tempmail.com. Todos os endpoints aceitam X-API-Key ou Authorization: Bearer.

1) List available domains

curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

2) Create a disposable address (1 hour)

curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "test", "expiryTime": 3600000, "domain": "chat-tempmail.com"}'

3) Poll for messages

curl https://chat-tempmail.com/api/emails/{emailId} \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

Recursos legíveis por máquina

URLs previsíveis que agentes podem descobrir pelo nome:

Especificação OpenAPI 3.1

Esquema completo da API REST com operationIds, parâmetros tipados e esquemas de resposta. Também em /api/openapi.json e /.well-known/openapi.json.

llms.txt

Visão geral do site e da API em markdown, com uma seção when-to-use para agentes. Servido como text/markdown ao enviar Accept: text/markdown.

Servidor MCP

Acesso nativo a ferramentas para Claude, Cursor e VS Code. Roda localmente via npm: mcp-server-tempmail.

Agent skill

Skill instalável que ensina aos agentes de código o fluxo completo: criar caixa, consultar, processar com IA.

CLI e pacote MCP

npx mcp-server-tempmail funciona sozinho como ferramenta estilo CLI; pacote npm oficial.

Autenticação

Sem dancinha de OAuth: crie uma chave de API na sua página de Perfil e envie como cabeçalho. As chaves têm as mesmas permissões da sua conta — regenere imediatamente em caso de vazamento.

1Entre e abra sua página de Perfil
2Crie uma chave de API (exibida uma só vez — guarde com segurança)
3Envie X-API-Key: YOUR_API_KEY (ou Authorization: Bearer YOUR_API_KEY) em cada requisição

X-API-Key: YOUR_API_KEY

Webhooks

Em vez de consultar, configure um webhook (POST /api/webhook) e o ChatTempMail fará POST de cada mensagem recebida para sua URL com o cabeçalho X-Webhook-Event: new_message. Responda 2xx rapidamente; entregas com falha são repetidas, então mantenha o endpoint idempotente.

Configure a webhook

curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "enabled": true}'

Sandbox e limites de taxa

Não há sandbox separado: toda conta pode criar endereços temporários de graça. Planos pagos desbloqueiam operações de IA (resumir/traduzir/QA/extrair), endereços permanentes e anexos. Endpoints de listagem retornam 20 itens por página; a paginação é baseada em cursor. Endpoints de IA têm limites diários por papel visíveis nos cabeçalhos de resposta X-AI-Remaining.

Suporte

Dúvidas, bugs, pedidos de funcionalidades:

GitHub E-mail