Liệt kê thư
Những gì đã đến, mới nhất trước, chỉ metadata. Đây là lệnh gọi để poll.
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 /temp-mail/inboxes/{id}/messages
Những gì đã đến, mới nhất trước, chỉ metadata. Đây là lệnh gọi để poll.
Token của inbox
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"Mọi lệnh gọi bên dưới đều mang token mà POST /temp-mail/inboxes đã trả về, trong cùng header Authorization: Bearer mà một API key dùng. Bản thân địa chỉ không cấp quyền gì cả, và sự tách bạch đó chính là điểm mấu chốt của tính năng chứ không phải thủ tục hình thức: một địa chỉ dùng một lần được trao cho chính bên mà bạn muốn giữ khoảng cách, ngay khi nó được cấp.
Id trong path phải trỏ tới đúng inbox mà token trỏ tới. Chỉ riêng token đã đủ xác định một inbox, nên đây là cẩn tắc vô áy náy, nhưng nhờ vậy một caller nhầm lẫn hai inbox sẽ nhận 404 thay vì âm thầm đọc nhầm thư.
Ví dụ
Mọi thứ một danh sách hiển thị đều là một cột trên một bảng có index, và không phần thân đã lưu nào bị đọc. limit từ 1 đến 50 và là tùy chọn; thời hạn thuê trả về trên cùng phản hồi, nên một tiến trình poll không cần lệnh gọi thứ hai để biết khi nào dừng.
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 là 400 ký tự đầu của phần thân dưới dạng văn bản, và thường đó là toàn bộ lý do inbox tồn tại. Một mã xác nhận thường nhìn thấy được mà không cần mở gì cả.
spam là nhận định của bộ heuristic dùng chung. Nó chỉ là một cờ và không hơn: không có gì bị cất đi, chuyển đi hay chặn lại, và thư vẫn nằm trong danh sách này dù thế nào.
seen đổi giá trị khi thư được truy xuất, không phải khi nó được liệt kê. Poll endpoint này không bao giờ đánh dấu thư nào là đã đọc.