تمديد الاستئجار
ساعة إضافية على وقت الانتهاء، بحد أقصى اليوم الذي يُقيَّد به الاستئجار. بلا متن للطلب.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
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 Not Found بدل أن يقرأ بريداً خاطئاً في صمت.
مثال
تُضاف الساعة إلى 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. وهذه هي النهاية: خذ عنواناً جديداً، أو صندوق بريد حقيقياً لا ينتهي.