Перейти к документации
API

Продлить аренду

Ещё час к сроку истечения, вплоть до суток, которыми ограничена аренда. Без тела запроса.

POSTapi.openemail.uk/temp-mail/inboxes/{id}/extend

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

POST /temp-mail/inboxes/{id}/extend

Ещё час к сроку истечения, вплоть до суток, которыми ограничена аренда. Без тела запроса.

Токен ящика

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

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

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

Пример

Час добавляется к expiresAt, а не к текущему моменту, поэтому продление, сделанное до истечения, сохраняет оставшееся время.

curl
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"
Ответ
{  "object": "temp_inbox",  "id": "tinb_9c2f41ab7d3e4c118a0f5d72",  "address": "[email protected]",  "domain": "freemailaddress.com",  "createdAt": "2026-09-01T10:00:00.000Z",  "expiresAt": "2026-09-01T13:00:00.000Z",  "extensionsLeft": 21,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

Двадцать три продления, и новый срок вдобавок ограничен 24 часами после createdAt, так что последнее может дать меньше полного часа, а аренда, созданная у самого потолка, не даёт ничего. extensionsLeft уже учитывает оба ограничения; читайте его и expiresAt, а не считайте свои вызовы сами.

На пределе приходит 409 conflict_error / extension_limit. На этом всё: берите новый адрес или настоящий почтовый ящик, который не истекает.