받은편지함 만들기
주소를 발급하고 그것을 읽는 토큰을 반환합니다. 본문을 포함해 모든 필드가 선택 사항입니다.
본인 키로 워크스페이스에 실제 호출을 실행합니다.
POST /temp-mail/inboxes
주소를 발급하고 그것을 읽는 토큰을 반환합니다. 본문을 포함해 모든 필드가 선택 사항입니다.
자격 증명 없음
export OE=https://api.openemail.ukAuthorization 헤더를 아예 보내지 마십시오. 이 API에서 헤더 없이 답하는 유일한 리소스입니다. 스코프를 주는 대신 키 검사 위에 등록되어 있는데, 제공하려는 것이 주소가 없는 사람을 위한 주소이고, 먼저 키를 요구하면 도구의 옷을 입은 리드 수집 폼이 되기 때문입니다.
예제
빈 본문도 유효하며 그것이 일반적인 경우입니다. 풀에서 고른 도메인에 생성된 로컬 파트가, 한 시간 임대로 발급됩니다.
curl -X POST "$OE/temp-mail/inboxes" -H "Content-Type: application/json" \ -d '{ "localPart": "octopus-signup", "ttlMinutes": 120 }'{ "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": 0, "messageLimit": 50, "lastMessageAt": null, "token": "oe_inbox_kQ8v…"}201이며, API 전체에서 token을 담는 유일한 응답입니다. 그 주소로 다른 일을 하기 전에 먼저 저장하십시오.
생성된 로컬 파트는 모음도 없고 헷갈리는 글자도 없는 알파벳에서 뽑은 12자이므로, 어떤 단어도 만들지 않고 화면에서 읽어도 살아남습니다.
거부될 수 있는 것은 모두 조정되지 않고 이름으로 거부됩니다. 422 unknown_domain, invalid_address, reserved_address, 또는 1에서 1440을 벗어난 ttlMinutes에 대한 invalid_parameter. 이미 쓰이고 있는 로컬 파트에는 409 address_taken. 발급 상한에서는 429 too_many_inboxes. 풀 도메인이 하나도 없는 설치본에서는 503 temp_mail_unavailable.
파라미터
본문
domainstring- `GET /temp-mail/domains`에 있는 것 중 하나. 생략하면 풀이 첫 도메인을 채우는 대신 무작위로 고릅니다. 인터넷의 모든 일회성 가입을 받는 도메인 하나는 그에 걸맞은 평판을 얻고, 그 평판은 그 도메인의 모든 주소가 공유합니다. 풀에 없는 도메인은 조용히 대체되지 않고 이름으로 거부됩니다(422 `unknown_domain`). 그러지 않으면 요청한 주소를 이미 복사해 갔을 것이기 때문입니다.
localPartstring- @ 앞부분을 직접 고르고 싶을 때 씁니다. 글자, 숫자, 점, 대시, 밑줄로 3자에서 32자이며, 글자나 숫자로 시작하고 끝나야 합니다. RFC 5321이 허용하는 것보다 좁은데, 이 문자열이 URL 경로와 `To:` 헤더와 HTML 페이지에 들어가기 때문입니다. `+`는 제외됩니다. 서브 어드레싱은 들어올 때 접히므로 `alice+bob`은 실제로는 받을 수 없는 이름이 됩니다. 이미 쓰인 이름은 409 `address_taken`으로 답하며 두 경우를 포함합니다. 다른 방문자가 갖고 있거나(또는 지난 일주일 안에 갖고 있어서 주소가 아직 회수 대기 중이거나), 도메인 소유자가 그것을 실제 주소로 만들어 둔 경우입니다. 후자도 같은 코드로 거부되는데, 그 주소로 온 메일은 소유자에게 가고 당신에게는 결코 오지 않기 때문입니다. `postmaster`를 비롯한 예약어는 422 `reserved_address`로 답합니다.
ttlMinutesnumber- 임대 길이를 분 단위로, 1에서 1440까지. 기본값은 60입니다. 범위를 벗어나면 조용히 조정되지 않고 해당 필드를 지목하는 422 `invalid_parameter`로 답합니다. 이미 요청한 만료 시각을 누군가에게 보여줬을 테니까요. 24시간은 생성 시점부터 재므로, 앞에서 당겨 쓴 한 시간은 나중에 쓸 수 없는 연장 한 번입니다. `ttlMinutes: 120`은 22회가 남은 상태로 돌아오고, 1440은 하나도 남지 않습니다.
응답: temp_inbox, 그리고 토큰
idstring- 받은편지함 id. `tinb_`와 24자의 16진수입니다. 다른 모든 호출의 경로에 들어가며, 비밀이 아닙니다. 비밀은 토큰입니다.
addressstring- 건네줄 주소입니다. 서브 어드레싱은 조회 전에 접히므로 `그주소+무엇이든@`으로 보낸 메일도 여기에 도착합니다.
domainstring- 주소가 속한 풀 도메인입니다. 클라이언트가 표시하려고 주소를 파싱하지 않아도 되도록 분리해 두었습니다.
createdAtstring- ISO-8601. 24시간 상한은 마지막 연장이 아니라 이 시점부터 잽니다.
expiresAtstring- ISO-8601. 이 시점이 지나면 토큰은 즉시 인증을 멈추고, 청소 작업이 다음 실행에서 메일을 삭제합니다.
extensionsLeftnumber- `extend`가 실제로 시간을 벌어 줄 수 있는 남은 횟수이며, 두 상한을 모두 셉니다. 임대가 허용하는 연장 23회와, `createdAt`으로부터 결코 넘을 수 없는 24시간 중 먼저 닿는 쪽입니다. `ttlMinutes: 1440`으로 만든 받은편지함은 아무것도 쓰지 않았는데도 0을 보고합니다. 0은 호출이 409로 답한다는 뜻이며, 클라이언트는 눌러 보고 알아내는 대신 그 값으로 버튼을 비활성화해야 합니다.
messageCountnumber- 이 받은편지함이 받아들인 메시지 수이며, 지금 보이는 개수가 아닙니다. 하나를 삭제해도 줄지 않습니다. 상한은 도착을 세므로, 삭제는 저장 공간을 비우지만 자리를 비우지는 않습니다.
messageLimitnumber- 상한값이며, 클라이언트가 우리 상수를 하드코딩하지 않고 "가득 참"이라고 말할 수 있도록 모든 받은편지함에 함께 보냅니다.
lastMessageAtstring | null- 메일이 마지막으로 도착한 시각, ISO-8601, 아직 없으면 null입니다. 2분째 기다리는 사람에게는 새 받은편지함의 null이 조용한 받은편지함의 값과 아주 다르게 읽힙니다.
tokenstring- 자격 증명이며, 이 응답에만 있고 다른 어디에도 없습니다. `oe_inbox_`와 base64url 43자입니다. 행에는 키가 적용된 해시만 저장되므로 다시 읽거나 복구할 수 없습니다.
다른 모든 받은편지함 응답(조회, 연장)은 token이 빠진 이 객체입니다.