Skip to main content

Что это

Mail API создаёт почтовые ящики и отдаёт пришедшие на них письма. Только приём — отправка не поддерживается. Авторизация — тем же API-ключом, что и Spam Check (подробнее). Ящики и письма видны только владельцу ключа.

Как это работает

1

Создайте ящик

POST /api/mail/mailboxes — получите адрес. Тело запроса необязательно.
2

Используйте адрес

Зарегистрируйтесь на нужном сервисе или отправьте письмо на этот адрес.
3

Получите письмо

GET /api/mail/mailboxes/{address}/wait дождётся письма и сразу отдаст его целиком, вместе с найденным кодом подтверждения в поле code.

Пример

Если за timeout письмо не пришло, /wait возвращает {"message": null} — повторите запрос. Передавайте since (например, created_at ящика), чтобы не пропустить письмо, пришедшее между запросами: без него /wait ждёт только письма, пришедшие после начала запроса.

Домены

  • Список доступных доменов — GET /api/mail/domains.
  • domain при создании ящика необязателен. Без него домен выбирается случайно для каждого ящика — при нескольких доменах ящики распределяются между ними.
  • Чтобы создать ящик на конкретном домене, передайте domain:
  • Домен, которого нет в списке, вернёт 400 с перечнем доступных.

Адрес ящика

  • name — имя до @. Не указано — генерируется адрес вида anna.smith42.
  • Допустимо 1–64 символа a-z 0-9 . _ -, в начале и в конце — буква или цифра. Регистр не важен.
  • Одно и то же имя можно занять на разных доменах.
  • Письма принимаются только на созданные ящики. На несуществующий адрес отправитель получит отказ.

+теги

Письма на name+любой_тег@domain приходят в ящик name@domain. Один ящик можно использовать для разных сервисов, а по полю to письма видно, на какой адрес оно пришло:

Код подтверждения

Поле code — код подтверждения, найденный в теме или тексте письма. Если кода нет или уверенности нет — null. Ссылки из письма API не извлекает: они есть в text и html.

Ограничения

  • Лимитов на запросы нет — rate limit не применяется.
  • Количество ящиков и писем не ограничено — ни на пользователя, ни на ящик, ни на домен.
  • Максимальный размер письма — 25 МБ. Более крупные письма отклоняются.
  • Письма хранятся 90 дней, затем удаляются. Ящик при этом остаётся.
  • /wait ждёт не дольше 55 секунд за запрос.
  • Список писем отдаётся страницами до 200 писем (limit, offset).

Сайт

Ящики также доступны в разделе «Временные почты» на taimly.net. Ящики, созданные через API, не показываются там в списке, чтобы не засорять его, — их можно открыть по адресу или закрепить через PATCH /api/mail/mailboxes/{address}.