تمدید اجاره
یک ساعت دیگر روی زمان انقضا، تا سقف یک روزی که هر اجاره به آن محدود است. بدون بدنه.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
POST /temp-mail/inboxes/{id}/extend
یک ساعت دیگر روی زمان انقضا، تا سقف یک روزی که هر اجاره به آن محدود است. بدون بدنه.
توکن صندوق
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"هر فراخوانی پایین، توکنی را حمل میکند که POST /temp-mail/inboxes برگردانده است، در همان هدر Authorization: Bearer که یک کلید API از آن استفاده میکند. خودِ نشانی هیچ مجوزی نمیدهد، و این جدایی نه یک تشریفات، که اصل ماجرای این قابلیت است: نشانی یکبارمصرف در همان لحظهٔ صدور به طرفی سپرده میشود که میخواهید در فاصله نگهش دارید.
شناسهٔ داخل مسیر باید همان صندوقی را نام ببرد که توکن نام میبرد. توکن بهتنهایی صندوق را مشخص میکند، پس این محکمکاری مضاعف است، اما یعنی فراخوانی که دو صندوق را قاطی کند بهجای آنکه بیسروصدا نامهٔ اشتباه را بخواند، 404 میگیرد.
نمونه
این یک ساعت به expiresAt افزوده میشود، نه به اکنون، پس تمدید در حالی که هنوز وقت باقی است، آن وقت باقیمانده را نگه میدارد.
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"}بیستوسه تمدید، و انقضای تازه هم به 24 ساعت پس از createdAt محدود میشود، پس آخرین تمدید ممکن است کمتر از یک ساعت کامل بخرد، و اجارهای که همان لحظهٔ سقف ساخته شده هیچ تمدیدی ندارد. extensionsLeft هر دو سقف را از پیش حساب کرده است؛ آن و expiresAt را بخوانید بهجای آنکه فراخوانیهای خودتان را بشمارید.
روی سقف، با 409 conflict_error / extension_limit پاسخ میدهد. ماجرا همینجا تمام است: نشانی تازهای بگیرید، یا یک صندوق واقعی که منقضی نمیشود.