Gia hạn lượt thuê
Thêm một giờ vào thời điểm hết hạn, tối đa tới mức trần một ngày của một lượt thuê. Không có body.
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.
POST /temp-mail/inboxes/{id}/extend
Thêm một giờ vào thời điểm hết hạn, tối đa tới mức trần một ngày của một lượt thuê. Không có body.
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ột giờ được cộng vào expiresAt, không phải vào thời điểm hiện tại, nên gia hạn khi vẫn còn thời gian sẽ giữ nguyên phần thời gian đó.
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "address": "[email protected]", "domain": "freemailaddress.com", "createdAt": "2026-09-01T10:00:00.000Z", "expiresAt": "2026-09-01T13:00:00.000Z", "extensionsLeft": 21, "messageCount": 3, "messageLimit": 50, "lastMessageAt": "2026-09-01T10:31:04.000Z"}Hai mươi ba lần gia hạn, và thời điểm hết hạn mới còn bị giới hạn ở mốc 24 giờ sau createdAt, nên lần cuối có thể mua được ít hơn một giờ trọn vẹn, và một lượt thuê tạo ngay ở mức trần thì không có lần nào. extensionsLeft đã tính cả hai trần; hãy đọc lại nó và expiresAt thay vì tự đếm số lệnh gọi của mình.
Khi chạm trần, nó trả về 409 conflict_error / extension_limit. Thế là hết: hãy lấy một địa chỉ mới, hoặc một hộp thư thật, thứ không bao giờ hết hạn.