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가 반환한 토큰을 API 키와 동일한 Authorization: Bearer 헤더에 담아 전달합니다. 주소 자체는 아무것도 인가하지 않으며, 이 분리는 형식적인 절차가 아니라 기능의 핵심입니다. 일회용 주소는 발급되는 순간 거리를 두고 대하려는 상대에게 건네지기 때문입니다.

경로의 id는 토큰이 가리키는 것과 같은 받은편지함을 가리켜야 합니다. 토큰만으로도 하나가 특정되므로 이는 이중 안전장치이지만, 덕분에 두 받은편지함을 혼동한 호출자는 엉뚱한 메일을 조용히 읽는 대신 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"}

연장은 23회까지이며 새 만료 시각도 createdAt 기준 24시간으로 제한되므로, 마지막 연장은 한 시간을 다 못 채울 수 있고 상한에서 만들어진 리스는 연장분이 아예 없습니다. extensionsLeft가 두 상한을 모두 반영해 계산하므로, 직접 호출 횟수를 세지 말고 이 값과 expiresAt을 되읽으세요.

상한에 도달하면 409 conflict_error / extension_limit를 응답합니다. 거기서 끝입니다. 새 주소를 받거나, 만료되지 않는 진짜 메일함을 쓰세요.