API

Hủy một inbox

Xóa thư ngay thay vì chờ hết hạn thuê.

DELETEapi.openemail.uk/temp-mail/inboxes/{id}

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.

DELETE /temp-mail/inboxes/{id}

Xóa thư ngay thay vì chờ hết hạn thuê.

Token của inbox

shell

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ụ

Các thư và phần thân đã lưu của chúng bị xóa ngay lập tức, và token ngừng xác thực từ request kế tiếp.

curl

curl -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"

Phản hồi

{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "destroyed": true }

Không có gì được lưu ở phía máy chủ. Lượt thuê là một token đã ký do trình duyệt giữ, nên một inbox hết hạn không để lại bản ghi nào và địa chỉ đơn giản là thôi bị chiếm giữ.

Một inbox đã bị hủy vẫn tính vào trần cấp phát. Vứt bỏ một cái không phải là cách để có thêm cái khác.