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

경로의 id는 토큰이 가리키는 것과 같은 받은편지함을 가리켜야 합니다. 토큰만으로도 하나가 특정되므로 이는 이중 안전장치이지만, 덕분에 두 받은편지함을 혼동한 호출자는 엉뚱한 메일을 조용히 읽는 대신 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입니다. "리스가 끝났다", "당신 것이 아니다", "그런 건 없었다"는 의도적으로 바깥에서 구별할 수 없게 되어 있으며, 메일함도 같은 이유로 이를 구별해 주지 않습니다.