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

نشر ملف على رابط عام

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

POSTapi.openemail.uk/files/{id}/links

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

POST /files/{id}/links

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

مثال

يتطلب files:write. الجسم اختياري. يسمّي domain النطاق الذي يقدّم مضيف ملفاته الرابط، مثل acme.com لـ files.acme.com. والجواب 201 مع الرابط الجديد.

curl
curl -X POST "$OE/files/file_6bb640f5b99e47deb758f1f5/links" -H "$AUTH" -H 'content-type: application/json' -d '{ "domain": "acme.com" }'
الاستجابة
{  "object": "file_link",  "id": "fshr_4d7a0c2e9b16f3584a2c7e90",  "fileId": "file_6bb640f5b99e47deb758f1f5",  "filename": "invoice-0912.pdf",  "mimeType": "application/pdf",  "sizeBytes": 184233,  "host": "files.acme.com",  "url": "https://files.acme.com/f/8c2e…/invoice-0912.pdf",  "downloads": 0,  "lastDownloadAt": null,  "revokedAt": null,  "createdAt": "2026-09-24T10:02:17.000Z"}

يُقدَّم الرابط على مضيف الملفات لـ domain حين يكون لذلك النطاق مضيف. ومن دونه، أو حين لا يكون لذلك النطاق مضيف، يُقدَّم على مضيف الملفات للعنوان الذي ينتمي إليه الملف، وإلا فعلى عنوان API.

الملف الذي وصل أو خرج مع رسالة يُنسخ أولًا إلى تخزين عام. ويُرفض البرنامج أو السكربت بـ 422 file_unshareable.

كل استدعاء يصنع رابطًا جديدًا بعدّاد تنزيلات خاص به، فإعادة المحاولة بعد ضياع الجواب تصنع رابطًا ثانيًا. اسرد الروابط بـ GET /files/{id}/links قبل المحاولة من جديد.

يظل الرابط يعمل حتى يُسحب أو يُحذف الملف.