API

Получить ящик

Аренда, число сообщений и оставшиеся продления. Состояние, вокруг которого клиент рисует список.

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

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

GET /temp-mail/inboxes/{id}

Аренда, число сообщений и оставшиеся продления. Состояние, вокруг которого клиент рисует список.

Токен ящика

shell

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

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

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

Пример

Дёшево: одна индексированная строка и никакого объектного хранилища. Если вам нужна почта, опрашивайте вместо этого список сообщений. Тот вызов несёт и срок аренды.

curl

curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"

Ответ

{  "object": "temp_inbox",  "id": "tinb_9c2f41ab7d3e4c118a0f5d72",  "address": "[email protected]",  "domain": "freemailaddress.com",  "createdAt": "2026-09-01T10:00:00.000Z",  "expiresAt": "2026-09-01T12:00:00.000Z",  "extensionsLeft": 22,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

Истёкший, уничтоженный и неизвестный ящик — один ответ: 404. «Ваша аренда закончилась», «это не ваше» и «такого никогда не было» намеренно неразличимы снаружи, и почтовый ящик отказывается их различать по той же причине.