Временная почта для ИИ-агентов
API временной почты без регистрации, который агенты могут находить и использовать самостоятельно. Создавайте ящики, ожидайте коды подтверждения, читайте и удаляйте сообщения и получайте их исходный текст через HTTPS.
# Откройте для себя доступные домены:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Создайте личный временный почтовый ящик. Регистрация и ключ API не нужны.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Дождитесь письма с подтверждением или кода OTP.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
-H 'Authorization: Inbox {token}' \
-H 'Content-Type: application/json' \
-d '{"codeOnly":true,"timeoutSeconds":60}'
# 3. Прочитайте сообщение полностью.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
-H 'Authorization: Inbox {token}'{
"inbox": {
"address": "agent-lx84a9-q3mz2@reusable.email",
"domain": "reusable.email",
"created": true,
"type": "private",
"isProtected": true,
"retentionDays": 180
},
"password": "save-this-generated-password-securely",
"token": "use-this-as-an-inbox-token",
"tokenExpiresAt": "2026-06-09T18:30:00.000Z",
"links": {
"web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
"messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
"wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
}
}{
"status": "message",
"inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
"message": {
"id": 1842,
"from": { "name": "Example", "address": "login@example.com" },
"subject": "Your verification code",
"intro": "Use code 123456 to continue.",
"verificationCode": "123456"
}
}Интерфейс агента
Манифест для обнаружения доступен по адресу /v1/agent-tempmail и продублирован в llms.txt для систем ответов.
| Метод | Путь | Назначение |
|---|---|---|
| GET | /v1/agent-tempmail | Манифест обнаружения для агентов и сканеров |
| GET | /v1/agent-tempmail/domains | Список доступных альтернативных доменов |
| POST | /v1/agent-tempmail/inboxes | Создайте личный почтовый ящик, защищенный паролем |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Список полученных сообщений |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Длительное ожидание писем или кодов (long polling) |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Прочитать сообщение |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Получить исходный текст письма в формате RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Удалить сообщение |
Потоки проверки
Используйте почтовый ящик агента для писем о регистрации, входе, сбросе пароля и подтверждении пробного периода.
Автоматизация браузера
Используйте его с Playwright, Selenium или агентом браузера, которому нужен настоящий адрес для получения писем.
CI и QA
Создавайте изолированные почтовые ящики для каждого тестового запуска без подготовки учетных записей или обмена учетными данными.
Часто задаваемые вопросы
Создание личного почтового ящика бесплатно и не требует регистрации. Чтобы выбрать другой домен, передайте домен из списка, полученного через API. Интерфейс агента предназначен только для получения почты. Для большего объёма или отправки писем используйте обычные API с учётной записью.
Можно ли использовать ключ доступа с почтовым ящиком агента?+
Да. Войдите в систему, используя сгенерированный пароль, и добавьте ключ доступа в настройках почтового ящика. Кнопка ключа в форме личного почтового ящика и на экране разблокировки папки «Входящие» поддерживают вход с ключом доступа. Полученный токен Inbox работает со всеми конечными точками почтовых ящиков агента. Ключи доступа требуют интерактивной проверки пользователя; сохраните пароль для автоматических агентов и обновите токены с истекшим сроком действия с помощью POST /v1/inbox/{address}/token и JSON {"password":"..."}.
Могу ли я выбрать альтернативный домен?+
Да. GET /v1/agent-tempmail/domains возвращает список доступных доменов. Передайте domain вместе с prefix или локальной частью адреса либо укажите полный адрес. Занятые и зарезервированные адреса получить нельзя.
Может ли ИИ-агент использовать это без регистрации?+
Да. Агент может создать почтовый ящик с одним неаутентифицированным запросом POST. Ответ включает в себя сгенерированный пароль и токен Inbox. Все созданные почтовые ящики являются частными. Сохраните пароль для обычного входа в личный почтовый ящик после истечения срока действия токена.
Требуется ли MCP, SDK или установка?+
Нет. Интерфейс полностью доступен через HTTPS и curl. Агенты могут обнаружить его через llms.txt или манифест JSON на /v1/agent-tempmail.
Могут ли агенты отправлять электронную почту через этот API?+
Нет. Интерфейс агента без регистрации позволяет только получать и читать письма, ожидать их, получать их исходный текст и удалять сообщения. Отправка писем намеренно исключена из этого открытого интерфейса.
Как предоставляются коды подтверждения?+
В ответах со списком сообщений, результатом ожидания и подробностями сообщения сначала используются корректные экспериментальные заголовки OTP-Token; если их нет или они недействительны, код ищется в тексте. Коды из заголовка сопровождаются полем verificationCodeOrigin: перед вводом кода точно сверьте его с источником назначения (схемой, доменом и портом). Это значение указывает отправитель; оно не подтверждает его личность. Никогда не переходите по нему автоматически.
Как долго хранятся почтовые ящики, созданные агентом?+
Созданные агентом почтовые ящики имеют обычные возможности личного почтового ящика и сохраняют сообщения в течение 180 дней.