ফাইল আপলোড করুন
আপলোড করার জন্য তিনটি ধাপ অনুসরণ করতে হয়: একটি আপলোড ঠিকানা অনুরোধ করা, ফাইলটি প্রেরণ করা এবং নথি নিশ্চিত করা। একটি আপলোড ঠিকানা একবার তৈরি করা যেতে পারে এবং সর্বোচ্চ ১ ঘণ্টা পর্যন্ত বৈধ থাকে।
1. একটি আপলোড ঠিকানা অনুরোধ করুন
Section titled “1. একটি আপলোড ঠিকানা অনুরোধ করুন”POST /api/v1/upload/presignX-API-Key: sk_your_keyContent-Type: application/json{ "filename": "report.docx", "file_size": 45678}| ক্ষেত্র | ধরন | প্রয়োজনীয় | বর্ণনা |
|---|---|---|---|
filename | স্ট্রিং | ✅ | ফাইলের নাম; সার্ভার এক্সটেনশন থেকে ফাইলের ধরন নির্ধারণ করে। |
file_size | পূর্ণসংখ্যা | ✅ | বাইটে সঠিক আকার, 0-এর চেয়ে বড় |
mime_type | স্ট্রিং | — | ঐচ্ছিক; সার্ভারটি এটি ব্যবহার করে না |
উত্তর:
{ "document_id": "4q8mx2q9z1k7p6ra", "upload_url": "https://upload.example/...", "upload_headers": { "Content-Type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "If-None-Match": "*" }, "finalize_token": "short_lived_token", "expires_in": 3600}2. ফাইলটি প্রেরণ করুন
Section titled “2. ফাইলটি প্রেরণ করুন”PUT থেকে upload_url-এ পাঠান, বডি হিসেবে রো ফাইল বাইটগুলি ব্যবহার করুন এবং upload_headers-এর প্রতিটি হেডার যেমন দেওয়া আছে, ঠিক তেমনই পাঠান।
# UPLOAD_URL and UPLOAD_CONTENT_TYPE come from upload_url and upload_headers["Content-Type"] in the previous responsecurl --fail-with-body -X PUT "$UPLOAD_URL" \ -H "Content-Type: $UPLOAD_CONTENT_TYPE" \ -H "If-None-Match: *" \ --upload-file "report.docx"এই ধাপে OmniDoc API কী প্রেরণ করবেন না। ঠিকানাটি মেয়াদোত্তীর্ণ হলে বা স্থানান্তর ব্যর্থ হলে, একটি নতুন অনুরোধ করুন।
3. নথিটি নিশ্চিত করুন
Section titled “3. নথিটি নিশ্চিত করুন”POST /api/v1/upload/finalizeX-API-Key: sk_your_keyContent-Type: application/json{"finalize_token":"short_lived_token"}সফল হলে নথিটি ফেরত দেওয়া হয়:
{ "document": { "id": "4q8mx2q9z1k7p6ra", "basename": "report.docx", "file_size": 45678, "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "created_at": "2026-10-01T12:00:00Z" }}শুধুমাত্র নিশ্চিতকরণের পরেই নথিটি ফাইল লাইব্রেরিতে যায় এবং কাজে ব্যবহারযোগ্য হয়।
ফাইলের নাম
Section titled “ফাইলের নাম”filename শুধুমাত্র প্রদর্শনের জন্য; এটিকে পথ বা অনন্য শনাক্তকারী হিসেবে ব্যবহার করবেন না। সার্ভার অবৈধ অক্ষরগুলোকে প্রতিস্থাপন করে এবং খুব দীর্ঘ নামগুলোর জন্য একটি নিরাপদ ডাউনলোড নাম তৈরি করে।
ত্রুটি
Section titled “ত্রুটি”| স্ট্যাটাস | কারণ |
|---|---|
400 | অবৈধ ফাইলের নাম বা আকার, অথবা আপলোড করা আকার অনুরোধ করা আকারের সাথে মিলছে না। |
401 | ক্রেডেনশিয়াল বা finalize_token অবৈধ বা মেয়াদোত্তীর্ণ |
403 | finalize_token অন্য একটি অ্যাকাউন্টের অন্তর্গত |
410 | আপলোড করা ফাইলটি পাওয়া যায়নি (স্থানান্তর অসম্পূর্ণ বা ঠিকানাটি মেয়াদোত্তীর্ণ); একটি নতুন ঠিকানা চান |
413 | ফাইল প্রতি আকারের সীমা অতিক্রম করেছে |
415 | অসমর্থিত ফরম্যাট, অথবা কনটেন্ট এক্সটেনশনের সাথে মেলে না। |
422 | Office ফাইলটি ক্ষতিগ্রস্ত বা গঠনগতভাবে অন安全 |
429 | অতিরিক্ত আপলোড |
503 | আপলোড পরিষেবা সাময়িকভাবে অনুপলব্ধ; পরে আবার চেষ্টা করুন |