Liệt kê tên miền
Mọi tên miền trong không gian làm việc, kèm trạng thái nhận thư, gửi thư, theo dõi và tệp.
Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.
GET /domains
Mọi tên miền trong không gian làm việc, kèm trạng thái nhận thư, gửi thư, theo dõi và tệp.
Nhận thư và gửi thư là tách biệt
Mỗi tên miền báo cáo việc nhận thư và gửi thư dưới dạng hai đối tượng trạng thái độc lập. receiving.verified nghĩa là bản ghi MX của tên miền đưa thư về đây và bản ghi xác minh quyền sở hữu đã được công bố, nên tên miền có thể nhận thư. Trường này không nói gì về thư gửi đi.
sending là nửa về thư gửi đi, được đọc từ kết quả kiểm tra ký thư đã lưu của tên miền chứ không phải từ một lần kiểm tra mới. sending.status là một trong verified, pending, failed, no_identity hoặc unknown, sending.canSend cho biết một lần gửi từ tên miền này có được chấp nhận ngay lúc này hay không, sending.checkedAt ghi thời điểm của kết luận đó, sending.error chứa lỗi gần nhất, và sending.note là một câu giải thích trạng thái. Một kết luận tiêu cực cũ hơn một ngày được coi là chưa xác định chứ không phải là từ chối, nên canSend có thể là true trong khi status là pending.
tracking là đối tượng thứ ba, nói về tên miền theo dõi tùy chỉnh không bắt buộc của tên miền chứ không phải về thư của nó. tracking.status là none cho đến khi một tên miền theo dõi được thiết lập, trong ứng dụng hoặc bằng PATCH /domains/{id}, trang của endpoint đó mô tả mọi trường.
storage là đối tượng thứ tư có cùng các trường, nói về tên miền tệp tùy chỉnh không bắt buộc của tên miền: tên được dùng trong liên kết tải xuống cho các tệp gửi từ tên miền này. Nó được thiết lập theo cùng cách và trên cùng trang, và storage.status là none cho đến khi được thiết lập.
Ví dụ
Cần domains:read.
curl "$OE/domains" -H "$AUTH"{ "object": "list", "data": [ { "object": "domain", "id": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "receiving": { "verified": true, "verifiedAt": "2026-08-14T10:02:00.000Z", "catchAll": false, "lastCheckedAt": "2026-08-29T06:00:00.000Z", "error": null }, "sending": { "status": "verified", "canSend": true, "checkedAt": "2026-08-29T06:00:00.000Z", "error": null, "note": "Mail from this domain is signed and can be sent." }, "tracking": { "host": "links.acme.com", "status": "active", "active": true, "target": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk", "record": { "type": "CNAME", "name": "links.acme.com", "value": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk" }, "checkedAt": "2026-08-29T06:10:00.000Z", "verifiedAt": "2026-08-29T06:10:00.000Z", "error": null }, "storage": { "host": "files.acme.com", "status": "active", "active": true, "target": "oefiles81c40d6b2f7e9a35.edge.openemail.uk", "record": { "type": "CNAME", "name": "files.acme.com", "value": "oefiles81c40d6b2f7e9a35.edge.openemail.uk" }, "checkedAt": "2026-08-29T06:10:00.000Z", "verifiedAt": "2026-08-29T06:10:00.000Z", "error": null }, "createdAt": "2026-08-14T09:55:11.000Z" } ]}lastCheckedAt bằng null nghĩa là DNS chưa từng được kiểm tra: “chúng tôi chưa kiểm tra”, chứ không phải “đã thất bại”. Hai ý này rất khác nhau khi bạn đọc chúng ba mươi giây sau khi thêm tên miền.