انتشار یک فایل در یک لینک عمومی
یک لینک دانلود عمومی میسازد که فایل را بدون ورود باز میکند، برای تصویر یا سندی که از یک ایمیل یا صفحهٔ وب به آن ارجاع داده میشود.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
POST /files/{id}/links
یک لینک دانلود عمومی میسازد که فایل را بدون ورود باز میکند، برای تصویر یا سندی که از یک ایمیل یا صفحهٔ وب به آن ارجاع داده میشود.
نمونه
به files:write نیاز دارد. بدنه اختیاری است. domain دامنهای را نام میبرد که میزبان فایلهایش لینک را ارائه میکند، مثل acme.com برای files.acme.com. پاسخ یک 201 همراه لینک تازه است.
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 فهرست کنید.
لینک تا وقتی لغو نشده یا فایل حذف نشده کار میکند.