Otwarte API
Twórz tymczasowe skrzynki i czytaj wiadomości przez proste API HTTP — idealne do testów automatycznych i weryfikacji rejestracji. Wszystkie endpointy zwracają JSON.
Uwierzytelnianie
Utworzenie skrzynki zwraca token. Wysyłaj go w kolejnych żądaniach:
Authorization: Bearer <token>
Limity
Bez klucza API każdy adres IP może utworzyć do 10 skrzynek na minutę. Aby uzyskać wyższe limity, wyślij klucz API przy tworzeniu:
X-API-Key: tm_xxxxxxxxxxxxxxxx
Endpointy
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /api/domains | Lista dostępnych domen |
| POST | /api/mailbox | Utwórz skrzynkę. Pusty body dla losowego adresu lub {"local":"abc","domain":"…"} dla własnego |
| GET | /api/mailbox | Informacje o bieżącej skrzynce |
| DELETE | /api/mailbox | Usuń skrzynkę i wszystkie wiadomości |
| GET | /api/messages | Lista odebranych (ostatnie 100) |
| GET | /api/messages/{id} | Pobierz wiadomość (treść i załączniki) |
| DELETE | /api/messages/{id} | Usuń wiadomość |
| GET | /api/messages/{id}/raw | Pobierz oryginalny .eml |
| GET | /api/attachments/{id} | Pobierz załącznik |
| GET | /api/events | Strumień zdarzeń SSE, wysyła event: mail przy nowych wiadomościach |
Przykłady
# 1. Utwórz skrzynkę. Pusty body dla losowego adresu lub {"local":"abc","domain":"…"} dla własnego
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. Lista odebranych (ostatnie 100)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. Pobierz wiadomość (treść i załączniki)
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)
Błędy
W razie błędu zwracany jest status inny niż 2xx z treścią JSON:
{"error": "rate_limited", "message": "…"}