API Temp Mail

Создавайте одноразовые ящики и читайте входящую почту программно — бесплатно, без ключа API.

Базовый URL

https://api1.mohmol.org

1. Список доступных доменов

Получите домены, на которых можно создавать адреса.

GET/api/domains

2. Создать адрес

Сгенерируйте случайный адрес. При желании передайте домен из списка выше; иначе используется домен по умолчанию.

POST/api/generate-email

3. Прочитать входящие

Получите сообщения, полученные адресом — отправитель, тема и декодированный текст/HTML.

GET/api/emails/{address}

4. Удалить входящие

Удалите все сообщения, сохранённые для адреса.

DELETE/api/delete/{address}

Быстрый пример

# 1) list available domains
curl https://api1.mohmol.org/api/domains

# 2) create an address (optionally choose a domain)
curl -X POST https://api1.mohmol.org/api/generate-email \
  -H "Content-Type: application/json" \
  -d '{"domain":"trythisemail.org"}'

# 3) read received emails for that address
curl https://api1.mohmol.org/api/emails/[email protected]

Лимиты запросов

Ограничение по IP: до 150 запросов в минуту в целом и 30 в минуту на создание/удаление адресов. Превышение лимита возвращает HTTP 429 с заголовком Retry-After.

Адреса должны использовать домен, возвращаемый /api/domains, с включённой маршрутизацией почты. Сообщения автоматически истекают после периода неактивности.