ফাইল লাইব্রেরি
ফাইল লাইব্রেরি বর্তমান অ্যাকাউন্ট দ্বারা অ্যাক্সেসযোগ্য সোর্স ফাইল, জব ফলাফল এবং অ্যাপ ফাইলগুলিকে প্রদর্শন করে। প্রতিটি আইটেমের একটি স্থিতিশীল file_id থাকে এবং কলার বর্তমানে যে কার্যক্রমগুলি সম্পাদন করতে পারে তা ফেরত দেয়।
অনুবাদের ইনপুট হিসেবে ব্যবহৃত ডকুমেন্টগুলোতেও /api/v1/documents তালিকা, বিশদ, আপডেট এবং মুছে ফেলার এন্ডপয়েন্ট রয়েছে। document_id প্রসেসিং জব তৈরির জন্য; file_id লাইব্রেরি-স্তরের অনুমতি এবং ডাউনলোডের জন্য। এই দুটি আইডি পরস্পর বিনিময়যোগ্য বলে ধরে নেবেন না।
তালিকা এবং বিস্তারিত
Section titled “তালিকা এবং বিস্তারিত”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}তালিকা প্রতিক্রিয়া:
{ "items": [ { "id": "x7m4q2k9n6c1v8pa", "name": "report.docx", "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "size_bytes": 45678, "status": "ready", "publication_status": "draft", "origin": { "product_code": "omnidoc-main", "display_name": "OmniDoc" }, "capabilities": { "can_view": true, "can_download": true, "can_update": true, "can_delete": true, "can_share": true }, "created_at": "2026-10-01T12:00:00Z", "updated_at": "2026-10-01T12:00:00Z" } ], "has_more": true, "next_offset": 50}পরবর্তী পৃষ্ঠা পেতে, offset হিসেবে next_offset পাস করুন; false যখন has_more হয় তখন থামুন।
প্রতিটি আইটেমের capabilities ব্যবহার করে সর্বদা সিদ্ধান্ত নিন যে এটি ডাউনলোড, শেয়ার বা কোনো অ্যাপের জন্য অনুমোদন করা যায় কিনা; উৎস ফিল্ড থেকে অনুমতি অনুমান করবেন না।
ডাউনলোড করুন
Section titled “ডাউনলোড করুন”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content পুনর্নির্দেশ (302) একটি অস্থায়ী ডাউনলোড ঠিকানায় প্রেরণ করে; পুনর্নির্দেশ অনুসরণ করার সময় API কী প্রেরণ করবেন না। প্রথমে একটি download-ticket চাওয়ার পরামর্শ দেওয়া হচ্ছে। একটি মেয়াদ শেষ হওয়ার পর নতুন ঠিকানা চান; এটি সংরক্ষণ করবেন না।
অনুমতি এবং লিঙ্কসমূহ
Section titled “অনুমতি এবং লিঙ্কসমূহ”GET /api/v1/storage/files/{file_id}/permissionsPOST /api/v1/storage/files/{file_id}/permissionsDELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/linksPOST /api/v1/storage/files/{file_id}/linksDELETE /api/v1/storage/files/{file_id}/links/{link_id}অনুমতি পরিবর্তন এবং সার্বজনীন লিঙ্ক আলাদা ক্ষমতা। আপনি যখন কোনো লিঙ্ক তৈরি করেন, তখন এর দর্শক, ডাউনলোডের অনুমতি, মেয়াদ এবং ঐচ্ছিক ডাউনলোড সংখ্যা স্পষ্টভাবে নির্ধারণ করুন; যখন এটি আর প্রয়োজন থাকবে না, তখনই এটি বাতিল করুন।
ওয়ার্কস্পেস ভিউস
Section titled “ওয়ার্কস্পেস ভিউস”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsওয়ার্কস্পেস এন্ডপয়েন্টগুলো একটি ফাইল সেন্টারের জন্য উপযুক্ত; /storage/files একটি নির্দিষ্ট ফাইলের অনুমতি এবং ডাউনলোড কর্মকাণ্ডের জন্য উপযুক্ত।