Тимчасова пошта для агента

Тимчасова пошта для агентів ШІ

API тимчасової пошти без реєстрації, який агенти можуть знаходити й використовувати автономно. Створюйте скриньки, очікуйте коди підтвердження, читайте та видаляйте повідомлення і отримуйте їхнє необроблене джерело через HTTPS.

Без реєстраціїБез ключа APIБез встановлення MCPДоступно через curl

Швидкий старт

# Відкрийте для себе доступні домени:
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

Створюйте окремі скриньки для кожного запуску тестів без створення облікових записів чи спільного використання облікових даних.

FAQ

Створення приватної скриньки безкоштовне й не потребує реєстрації. Щоб вибрати інший домен, передайте домен зі списку, отриманого через 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 днів.