API

Уничтожить ящик

Удаляет почту сразу, не дожидаясь окончания аренды.

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

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

DELETE /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 -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"

Ответ

{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "destroyed": true }

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

Уничтоженный ящик всё равно засчитывается в потолок выпуска. Выбросить один — не способ получить ещё один.