API

حذف رسالة

رسالة واحدة ومتنها ومرفقاتها، بطلب منك لا بانتظار الكنس الدوري.

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

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

DELETE /temp-mail/inboxes/{id}/messages/{messageId}

رسالة واحدة ومتنها ومرفقاتها، بطلب منك لا بانتظار الكنس الدوري.

رمز صندوق الوارد

shell

export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"

كل طلب أدناه يحمل الرمز الذي أعاده POST /temp-mail/inboxes، في ترويسة Authorization: Bearer ذاتها التي يستخدمها مفتاح الـ API. العنوان نفسه لا يمنح أي صلاحية، وهذا الفصل هو جوهر الميزة لا إجراء شكلي: فالعنوان المؤقت يُسلَّم منذ لحظة إصداره إلى الطرف الذي تبقيه على مسافة.

يجب أن يشير المعرّف في المسار إلى صندوق الوارد نفسه الذي يشير إليه الرمز. الرمز وحده كافٍ للتعريف، فهذا احتياط مزدوج، لكنه يعني أن المستدعي الذي يخلط بين صندوقين يتلقى 404 Not Found بدل أن يقرأ بريداً خاطئاً في صمت.

مثال

يذهب الصف وكل كائن تحته معاً. ويبقى messageCount كما هو: فسقف الخمسين رسالة يعدّ ما وصل، ومن ثمّ يحرّر الحذف مساحة تخزين لا مكاناً جديداً.

curl

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

الاستجابة

{ "object": "temp_message", "id": "tmail_4b81c07d2fa9418e93c6a13f", "deleted": true }

لا سلة محذوفات ولا تراجع عن الحذف. وفي صندوق وارد مؤقت هذه هي الميزة نفسها.

الصندوق الممتلئ يبقى ممتلئاً. والبريد الواصل إليه يُسقَط عند الباب، بلا ارتداد ولا شيء يُجلب لاحقاً، فالمخرج عنوان جديد لا إفراغ الصندوق.