किसी फ़ाइल को सार्वजनिक लिंक पर प्रकाशित करें
एक सार्वजनिक डाउनलोड लिंक बनाता है जो फ़ाइल को बिना साइन-इन के खोलता है, किसी ईमेल या वेब पेज से जुड़ी इमेज या दस्तावेज़ के लिए।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
POST /files/{id}/links
एक सार्वजनिक डाउनलोड लिंक बनाता है जो फ़ाइल को बिना साइन-इन के खोलता है, किसी ईमेल या वेब पेज से जुड़ी इमेज या दस्तावेज़ के लिए।
उदाहरण
files:write चाहिए। body वैकल्पिक है। domain उस डोमेन का नाम है जिसका फ़ाइल होस्ट लिंक परोसता है, जैसे files.acme.com के लिए 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 से लिंक सूचीबद्ध करें।
लिंक तब तक काम करता है जब तक उसे रद्द न किया जाए या फ़ाइल हटा न दी जाए।