Відкритий 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": "…"}