Что это
Mail API создаёт почтовые ящики и отдаёт пришедшие на них письма. Только приём — отправка не поддерживается. Авторизация — тем же API-ключом, что и Spam Check (подробнее). Ящики и письма видны только владельцу ключа.Как это работает
1
Создайте ящик
POST /api/mail/mailboxes — получите адрес. Тело запроса необязательно.2
Используйте адрес
Зарегистрируйтесь на нужном сервисе или отправьте письмо на этот адрес.
3
Получите письмо
GET /api/mail/mailboxes/{address}/wait дождётся письма и сразу отдаст его целиком, вместе с найденным кодом подтверждения в поле code.Пример
Домены
- Список доступных доменов —
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}.
