API aberta
Crie caixas temporárias e leia emails com uma API HTTP simples, ideal para testes automatizados e verificação de cadastros. Todos os endpoints retornam JSON.
Autenticação
Criar uma caixa retorna um token. Envie-o nas solicitações seguintes:
Authorization: Bearer <token>
Limites de uso
Sem chave de API, cada IP pode criar até 10 caixas por minuto. Para limites maiores, envie uma chave de API ao criar caixas:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| Método | Caminho | Descrição |
|---|---|---|
| GET | /api/domains | Listar domínios disponíveis |
| POST | /api/mailbox | Criar uma caixa. Corpo vazio para endereço aleatório, ou {"local":"abc","domain":"…"} para um personalizado |
| GET | /api/mailbox | Informações da caixa atual |
| DELETE | /api/mailbox | Excluir a caixa e todos os seus emails |
| GET | /api/messages | Listar a caixa de entrada (últimos 100) |
| GET | /api/messages/{id} | Obter um email (corpo e anexos) |
| DELETE | /api/messages/{id} | Excluir um email |
| GET | /api/messages/{id}/raw | Baixar o .eml original |
| GET | /api/attachments/{id} | Baixar um anexo |
| GET | /api/events | Fluxo de eventos SSE, envia event: mail quando chegam novos emails |
Exemplos
# 1. Criar uma caixa. Corpo vazio para endereço aleatório, ou {"local":"abc","domain":"…"} para um personalizado
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Listar a caixa de entrada (últimos 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Obter um email (corpo e anexos)
curl -s https://www.temp-mail.cc/api/messages/123 \
-H 'Authorization: Bearer <token>'
# Python
import requests, time
base = "https://www.temp-mail.cc"
mb = requests.post(f"{base}/api/mailbox", json={}).json()
headers = {"Authorization": f"Bearer {mb['token']}"}
print(mb["address"])
while True:
msgs = requests.get(f"{base}/api/messages", headers=headers).json()["messages"]
if msgs:
print(requests.get(f"{base}/api/messages/{msgs[0]['id']}", headers=headers).json()["text"])
break
time.sleep(3)
Erros
Em caso de erro, é retornado um status diferente de 2xx com corpo JSON:
{"error": "rate_limited", "message": "…"}