API abierta
Crea buzones temporales y lee correos con una API HTTP sencilla, ideal para pruebas automatizadas y verificación de registros. Todos los endpoints devuelven JSON.
Autenticación
Al crear un buzón se devuelve un token. Envíalo en las siguientes solicitudes:
Authorization: Bearer <token>
Límites de uso
Sin clave de API, cada IP puede crear hasta 10 buzones por minuto. Para límites mayores, envía una clave de API al crear buzones:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/domains | Lista de dominios disponibles |
| POST | /api/mailbox | Crear un buzón. Cuerpo vacío para una dirección aleatoria, o {"local":"abc","domain":"…"} para una personalizada |
| GET | /api/mailbox | Información del buzón actual |
| DELETE | /api/mailbox | Eliminar el buzón y todos sus correos |
| GET | /api/messages | Listar la bandeja (últimos 100) |
| GET | /api/messages/{id} | Obtener un correo (cuerpo y adjuntos) |
| DELETE | /api/messages/{id} | Eliminar un correo |
| GET | /api/messages/{id}/raw | Descargar el .eml original |
| GET | /api/attachments/{id} | Descargar un adjunto |
| GET | /api/events | Flujo de eventos SSE, envía event: mail al llegar correos nuevos |
Ejemplos
# 1. Crear un buzón. Cuerpo vacío para una dirección aleatoria, o {"local":"abc","domain":"…"} para una personalizada
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 la bandeja (últimos 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Obtener un correo (cuerpo y adjuntos)
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)
Errores
En caso de error se devuelve un estado distinto de 2xx con un cuerpo JSON:
{"error": "rate_limited", "message": "…"}