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

سرد الرسائل

ما وصل، الأحدث أولاً، بيانات وصفية فقط. هذا هو الطلب الذي تستطلعه دورياً.

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

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

GET /temp-mail/inboxes/{id}/messages

ما وصل، الأحدث أولاً، بيانات وصفية فقط. هذا هو الطلب الذي تستطلعه دورياً.

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

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

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

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

مثال

كل ما ترسمه القائمة عمود في جدول واحد مفهرس، ولا يُقرأ أي متن مخزَّن. القيمة limit بين 1 و50 واختيارية؛ وتعود مدة الاستئجار في الاستجابة نفسها، فلا يحتاج المستطلِع إلى طلب ثانٍ ليعرف متى يتوقف.

curl
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"
الاستجابة
{  "object": "list",  "data": [    {      "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": false,      "attachmentCount": 0,      "sizeBytes": 8241,      "receivedAt": "2026-09-01T10:31:04.000Z"    }  ],  "expiresAt": "2026-09-01T12:00:00.000Z"}

الحقل snippet هو أول 400 حرف من المتن كنص، وهو عادةً كل سبب وجود صندوق الوارد. فرمز التأكيد يكون ظاهراً في الغالب دون فتح أي شيء.

الحقل spam هو ما رجّحته الاستدلالات المشتركة. وهو راية لا أكثر: لم يُحفظ شيء جانباً ولم يُنقل ولم يُكتم، والرسالة في هذه القائمة في الحالتين.

ينقلب seen عند جلب الرسالة لا عند سردها. واستطلاع نقطة النهاية هذه لا يضع علامة القراءة على شيء أبداً.