API

Удалить сообщение

Одно сообщение, его тело и вложения — по вашей просьбе, а не по расписанию уборки.

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

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

DELETE /temp-mail/inboxes/{id}/messages/{messageId}

Одно сообщение, его тело и вложения — по вашей просьбе, а не по расписанию уборки.

Токен ящика

shell

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

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

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

Пример

Строка и все объекты под ней уходят вместе. messageCount не меняется: потолок в 50 сообщений считает то, что пришло, так что удаление освобождает хранилище, но не место.

curl

curl -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages/tmail_4b81c07d2fa9418e93c6a13f" \  -H "$INBOX"

Ответ

{ "object": "temp_message", "id": "tmail_4b81c07d2fa9418e93c6a13f", "deleted": true }

Ни корзины, ни отмены удаления. Для одноразового ящика это и есть нужное поведение.

Полный ящик остаётся полным. Почта, приходящая в такой ящик, отбрасывается на пороге, без отбоя и без возможности получить её позже, так что выход — новый адрес, а не расчистка.