تخطَّ إلى المستندات
API

جلب رسالة

رسالة واحدة مع متنها. وجلبها هو ما يضع عليها علامة المشاهَدة.

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

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

GET /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 بدل أن يقرأ بريداً خاطئاً في صمت.

مثال

يُجلب الصف أولاً وهو محصور بصندوق الوارد، ثم يُجلب المتن. فالذهاب مباشرة إلى التخزين بمعرّف يقدّمه المستدعي يتيح لأي حامل لمعرّف رسالة أن يقرأ أي صندوق وارد، لأن مفتاح التخزين ليس صلاحية.

curl
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages/tmail_4b81c07d2fa9418e93c6a13f" \  -H "$INBOX"
الاستجابة
{  "object": "temp_message",  "id": "tmail_4b81c07d2fa9418e93c6a13f",  "from": { "name": "Acme", "email": "[email protected]" },  "to": "[email protected]",  "subject": "Confirm your email",  "snippet": "Your code is 481923…",  "spam": false,  "seen": true,  "attachmentCount": 1,  "sizeBytes": 8241,  "receivedAt": "2026-09-01T10:31:04.000Z",  "message": { "decodedBody": "<p>Your code is 481923</p>", "…": "…" },  "truncated": false}

اعرض message.decodedBody. أما body وprocessedHtml فسلسلتان فارغتان في أي رسالة مستوعَبة محلياً، وهي كل رسالة يمكن أن تصل إلى صندوق وارد مؤقت. وقراءة أيٍّ منهما ثم عدم إيجاد شيء هي الغلطة التي وُضعت هذه الملاحظة لتفاديها.

الحقل message هو الكائن نفسه الذي يخزّنه صندوق البريد الحقيقي، ممرَّراً بلا إسقاط: فالبنية هي مخطط التخزين عينه، وأي قائمة حقول مكتوبة يدوياً هنا ستكون وصفاً ثانياً له يتقادم. وهو أيضاً HTML من مصدر قد يكون مهاجماً، فاعرضه خارج أصل موقعك.

يعني truncated أن المتن قُطع عند 2 ميغابايت. والرسالة سليمة فيما عدا ذلك؛ لم يُسقط منها شيء.

الصف الذي كُنس متنه المخزَّن مسبقاً يردّ بـ 404 Not Found مع «أُزيلت هذه الرسالة من قبل» بدل أن يفشل بعد ثلاث خطوات عند التحليل.