API
سرد الملفات
كل مرفق يحتفظ به صندوق البريد، مُرسلًا ومُستلمًا.
GETapi.openemail.uk/files
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /files
كل مرفق يحتفظ به صندوق البريد، مُرسلًا ومُستلمًا.
مثال
يتطلب threads:read، لأن الملف جزء من البريد الذي جاء معه. يبحث q في الاسم والنوع، ويُبقي kind واحدًا من image أو pdf أو audio أو video أو text، وsort هو newest أو oldest أو largest أو name.
curl "$OE/files?kind=pdf&sort=largest" -H "$AUTH"{ "object": "list", "data": [{ "object": "file", "id": "file_6bb640f5b99e47deb758f1f5", "filename": "invoice-0912.pdf", "mimeType": "application/pdf", "sizeBytes": 184233, "direction": "inbound", "threadId": "thread_2f9b…", "messageId": "<CAF7x…@mail.gmail.com>", "deliveredTo": "[email protected]", "createdAt": "2026-09-12T08:41:03.000Z" }], "hasMore": false, "nextCursor": null}المفتاح المقصور على عناوين أو نطاقات بعينها لا يرى إلا الملفات التي وصلت إليها، وهي الحدود نفسها التي تستخدمها قائمة السلاسل. ولا يُسرد الملف المحذوف.
يبدأ الفهرس من يوم إطلاقه. أما المرفقات الأقدم فما زالت على رسائلها، حيث يقرؤها GET /threads/{id}/messages/{messageId}/attachments.
يستمر المؤشر بالترتيب الذي سُلِّم به، والمؤشر المسلَّم تحت sort آخر يعني 400 invalid_cursor.