Открытый API
Создавайте временные ящики и читайте письма через простой HTTP API — идеально для автотестов и проверки регистрации. Все методы возвращают JSON.
Аутентификация
При создании ящика возвращается токен. Передавайте его в следующих запросах:
Authorization: Bearer <token>
Ограничения
Без API-ключа каждый IP может создать до 10 ящиков в минуту. Для более высоких лимитов передайте API-ключ при создании:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Методы
| Метод | Путь | Описание |
|---|---|---|
| GET | /api/domains | Список доступных доменов |
| POST | /api/mailbox | Создать ящик. Пустое тело — случайный адрес, или {"local":"abc","domain":"…"} — свой адрес |
| GET | /api/mailbox | Информация о текущем ящике |
| DELETE | /api/mailbox | Удалить ящик и все письма |
| GET | /api/messages | Список входящих (последние 100) |
| GET | /api/messages/{id} | Получить письмо (текст и вложения) |
| DELETE | /api/messages/{id} | Удалить письмо |
| GET | /api/messages/{id}/raw | Скачать исходный .eml |
| GET | /api/attachments/{id} | Скачать вложение |
| GET | /api/events | Поток событий SSE, отправляет event: mail при новых письмах |
Примеры
# 1. Создать ящик. Пустое тело — случайный адрес, или {"local":"abc","domain":"…"} — свой адрес
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Список входящих (последние 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Получить письмо (текст и вложения)
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)
Ошибки
При ошибке возвращается статус не 2xx и тело JSON:
{"error": "rate_limited", "message": "…"}