API

메시지 목록 조회

도착한 메일을 최신순으로, 메타데이터만 돌려줍니다. 폴링할 때 쓰는 호출입니다.

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

본인 키로 워크스페이스에 실제 호출을 실행합니다.

GET /temp-mail/inboxes/{id}/messages

도착한 메일을 최신순으로, 메타데이터만 돌려줍니다. 폴링할 때 쓰는 호출입니다.

받은편지함 토큰

shell

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

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

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

예시

목록이 그리는 모든 값은 인덱싱된 테이블 하나의 컬럼이며, 저장된 본문은 읽지 않습니다. limit은 1에서 50까지이고 선택 사항이며, 같은 응답에 리스 정보가 함께 담기므로 폴러는 언제 멈출지 알기 위해 두 번째 호출을 할 필요가 없습니다.

curl

curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"

응답

{  "object": "list",  "data": [    {      "object": "temp_message",      "id": "tmail_4b81c07d2fa9418e93c6a13f",      "from": { "name": "Acme", "email": "[email protected]" },      "to": "[email protected]",      "subject": "Confirm your email",      "snippet": "Your code is 481923…",      "spam": false,      "seen": false,      "attachmentCount": 0,      "sizeBytes": 8241,      "receivedAt": "2026-09-01T10:31:04.000Z"    }  ],  "expiresAt": "2026-09-01T12:00:00.000Z"}

snippet은 본문 앞부분 400자를 텍스트로 담은 것으로, 대개 받은편지함을 만든 이유 그 자체입니다. 인증 코드는 보통 아무것도 열지 않고도 보입니다.

spam은 공용 휴리스틱의 판단입니다. 플래그일 뿐이며, 어디론가 분류되거나 이동되거나 숨겨진 것은 없고 메시지는 어느 쪽이든 이 목록에 들어 있습니다.

seen은 메시지를 조회할 때 바뀌며, 목록에 나올 때는 바뀌지 않습니다. 이 엔드포인트를 폴링해도 읽음 처리되는 것은 없습니다.