웹 앱 주소 조회

워크스페이스의 웹 앱 주소, 사람들이 그곳에서 로그인할 수 있는지 여부, 그리고 필요한 CNAME 레코드. 설정된 주소가 없으면 status는 none이고, domains에는 주소를 둘 수 있는 도메인이 나열됩니다.

export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"

유료 요금제의 워크스페이스는 openemail.uk뿐 아니라 검증된 도메인 중 하나의 하위 도메인, 예를 들어 mailbox.acme.com에서도 웹 앱을 열 수 있습니다. 워크스페이스 Appearance 설정의 브랜드 앱 탭에서 설정하는 주소이며, 워크스페이스마다 최대 하나만 둘 수 있습니다.

그곳에는 워크스페이스의 멤버, 워크스페이스의 주소 중 하나로 로그인하는 사람, 그리고 대기 중인 초대가 있는 사람만 로그인할 수 있으며, 그곳에서 보내는 비밀번호 재설정 및 인증 이메일도 이들만 받습니다. 워크스페이스가 Appearance 페이지에서 로고를 설정하기 전까지는 openemail.uk처럼 보이고, 설정하면 저희 것 대신 워크스페이스의 로고, 마크, 이름이 보입니다. 그때부터 OpenEmail이 이들에게 보내는 이메일에는 브랜드가 들어가고, 링크는 그 주소로 돌아오며, 해당 도메인의 서명 레코드가 인증되면 그 도메인의 noreply@에서 발송됩니다.

CNAME 레코드 하나가 필요하며, 그 내용은 record에 자세히 나옵니다. 주소는 레코드가 응답하고 인증서가 발급될 때까지 pending이고, 그 뒤로는 active입니다. 무료 요금제에서는 주소가 유지되지만 일시 중지됩니다: paused가 true이고, 워크스페이스가 다시 유료 요금제가 될 때까지 아무도 그곳에 로그인할 수 없습니다.

domains:read가 필요합니다.

curl "$OE/app-host" -H "$AUTH"

{  "object": "app_host",  "id": "ahost_3f9c2a71d0b84e56a1c7f2e9",  "host": "mailbox.acme.com",  "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f",  "domain": "acme.com",  "status": "active",  "active": true,  "paused": false,  "target": "cname.openemail.uk",  "record": {    "type": "CNAME",    "name": "mailbox.acme.com",    "value": "cname.openemail.uk"  },  "error": null,  "checkedAt": "2026-10-01T09:12:30.000Z",  "verifiedAt": "2026-10-01T09:04:11.000Z",  "available": true,  "paidPlan": true,  "domains": ["acme.com"],  "suggested": "mailbox.acme.com"}