跳转到内容

ফাইল লাইব্রেরি

ফাইল লাইব্রেরি বর্তমান অ্যাকাউন্ট দ্বারা অ্যাক্সেসযোগ্য সোর্স ফাইল, জব ফলাফল এবং অ্যাপ ফাইলগুলিকে প্রদর্শন করে। প্রতিটি আইটেমের একটি স্থিতিশীল file_id থাকে এবং কলার বর্তমানে যে কার্যক্রমগুলি সম্পাদন করতে পারে তা ফেরত দেয়।

অনুবাদের ইনপুট হিসেবে ব্যবহৃত ডকুমেন্টগুলোতেও /api/v1/documents তালিকা, বিশদ, আপডেট এবং মুছে ফেলার এন্ডপয়েন্ট রয়েছে। document_id প্রসেসিং জব তৈরির জন্য; file_id লাইব্রেরি-স্তরের অনুমতি এবং ডাউনলোডের জন্য। এই দুটি আইডি পরস্পর বিনিময়যোগ্য বলে ধরে নেবেন না।

তালিকা এবং বিস্তারিত

Section titled “তালিকা এবং বিস্তারিত”
GET /api/v1/storage/files?offset=0&limit=50
GET /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 ব্যবহার করে সর্বদা সিদ্ধান্ত নিন যে এটি ডাউনলোড, শেয়ার বা কোনো অ্যাপের জন্য অনুমোদন করা যায় কিনা; উৎস ফিল্ড থেকে অনুমতি অনুমান করবেন না।

GET /api/v1/storage/files/{file_id}/content
POST /api/v1/storage/files/{file_id}/download-ticket

/content পুনর্নির্দেশ (302) একটি অস্থায়ী ডাউনলোড ঠিকানায় প্রেরণ করে; পুনর্নির্দেশ অনুসরণ করার সময় API কী প্রেরণ করবেন না। প্রথমে একটি download-ticket চাওয়ার পরামর্শ দেওয়া হচ্ছে। একটি মেয়াদ শেষ হওয়ার পর নতুন ঠিকানা চান; এটি সংরক্ষণ করবেন না।

অনুমতি এবং লিঙ্কসমূহ

Section titled “অনুমতি এবং লিঙ্কসমূহ”
GET /api/v1/storage/files/{file_id}/permissions
POST /api/v1/storage/files/{file_id}/permissions
DELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/links
POST /api/v1/storage/files/{file_id}/links
DELETE /api/v1/storage/files/{file_id}/links/{link_id}

অনুমতি পরিবর্তন এবং সার্বজনীন লিঙ্ক আলাদা ক্ষমতা। আপনি যখন কোনো লিঙ্ক তৈরি করেন, তখন এর দর্শক, ডাউনলোডের অনুমতি, মেয়াদ এবং ঐচ্ছিক ডাউনলোড সংখ্যা স্পষ্টভাবে নির্ধারণ করুন; যখন এটি আর প্রয়োজন থাকবে না, তখনই এটি বাতিল করুন।

ওয়ার্কস্পেস ভিউস

Section titled “ওয়ার্কস্পেস ভিউস”
GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

ওয়ার্কস্পেস এন্ডপয়েন্টগুলো একটি ফাইল সেন্টারের জন্য উপযুক্ত; /storage/files একটি নির্দিষ্ট ফাইলের অনুমতি এবং ডাউনলোড কর্মকাণ্ডের জন্য উপযুক্ত।