API

Список сообщений

Что пришло, новое сверху, только метаданные. Именно этот вызов стоит опрашивать.

GETapi.openemail.uk/temp-mail/inboxes/{id}/messages

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

GET /temp-mail/inboxes/{id}/messages

Что пришло, новое сверху, только метаданные. Именно этот вызов стоит опрашивать.

Токен ящика

shell

export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"

Каждый вызов ниже передаёт токен, который вернул POST /temp-mail/inboxes, в том же заголовке Authorization: Bearer, что использует ключ API. Сам адрес не даёт никаких прав, и это разделение — суть возможности, а не формальность: одноразовый адрес вручается той стороне, которую вы держите на расстоянии вытянутой руки, в тот же миг, когда он выдан.

Идентификатор в пути должен указывать на тот же ящик, что и токен. Токен и сам определяет ящик, так что это подстраховка, но благодаря ей клиент, перепутавший два ящика, получит 404, а не прочитает тихо чужую почту.

Пример

Всё, что рисует список, — это колонки одной индексированной таблицы, и ни одно сохранённое тело не читается. limit от 1 до 50 и необязателен; срок аренды приходит в том же ответе, так что опрашивающему не нужен второй вызов, чтобы понять, когда остановиться.

curl

curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"

Ответ

{  "object": "list",  "data": [    {      "object": "temp_message",      "id": "tmail_4b81c07d2fa9418e93c6a13f",      "from": { "name": "Acme", "email": "[email protected]" },      "to": "[email protected]",      "subject": "Confirm your email",      "snippet": "Your code is 481923…",      "spam": false,      "seen": false,      "attachmentCount": 0,      "sizeBytes": 8241,      "receivedAt": "2026-09-01T10:31:04.000Z"    }  ],  "expiresAt": "2026-09-01T12:00:00.000Z"}

snippet — первые 400 символов тела в виде текста, а это обычно и есть вся причина существования ящика. Код подтверждения, как правило, виден без открытия сообщения.

spam — это то, что решила общая эвристика. Это всего лишь флаг: ничего не было отложено, перемещено или подавлено, и сообщение в любом случае есть в этом списке.

seen переключается, когда сообщение получено, а не когда оно перечислено. Опрос этого эндпоинта никогда ничего не помечает прочитанным.