跳转到内容

ফাইল আপলোড করুন

আপলোড করার জন্য তিনটি ধাপ অনুসরণ করতে হয়: একটি আপলোড ঠিকানা অনুরোধ করা, ফাইলটি প্রেরণ করা এবং নথি নিশ্চিত করা। একটি আপলোড ঠিকানা একবার তৈরি করা যেতে পারে এবং সর্বোচ্চ ১ ঘণ্টা পর্যন্ত বৈধ থাকে।

1. একটি আপলোড ঠিকানা অনুরোধ করুন

Section titled “1. একটি আপলোড ঠিকানা অনুরোধ করুন”
POST /api/v1/upload/presign
X-API-Key: sk_your_key
Content-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-এর প্রতিটি হেডার যেমন দেওয়া আছে, ঠিক তেমনই পাঠান।

Terminal window
# UPLOAD_URL and UPLOAD_CONTENT_TYPE come from upload_url and upload_headers["Content-Type"] in the previous response
curl --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/finalize
X-API-Key: sk_your_key
Content-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"
}
}

শুধুমাত্র নিশ্চিতকরণের পরেই নথিটি ফাইল লাইব্রেরিতে যায় এবং কাজে ব্যবহারযোগ্য হয়।

filename শুধুমাত্র প্রদর্শনের জন্য; এটিকে পথ বা অনন্য শনাক্তকারী হিসেবে ব্যবহার করবেন না। সার্ভার অবৈধ অক্ষরগুলোকে প্রতিস্থাপন করে এবং খুব দীর্ঘ নামগুলোর জন্য একটি নিরাপদ ডাউনলোড নাম তৈরি করে।

স্ট্যাটাসকারণ
400অবৈধ ফাইলের নাম বা আকার, অথবা আপলোড করা আকার অনুরোধ করা আকারের সাথে মিলছে না।
401ক্রেডেনশিয়াল বা finalize_token অবৈধ বা মেয়াদোত্তীর্ণ
403finalize_token অন্য একটি অ্যাকাউন্টের অন্তর্গত
410আপলোড করা ফাইলটি পাওয়া যায়নি (স্থানান্তর অসম্পূর্ণ বা ঠিকানাটি মেয়াদোত্তীর্ণ); একটি নতুন ঠিকানা চান
413ফাইল প্রতি আকারের সীমা অতিক্রম করেছে
415অসমর্থিত ফরম্যাট, অথবা কনটেন্ট এক্সটেনশনের সাথে মেলে না।
422Office ফাইলটি ক্ষতিগ্রস্ত বা গঠনগতভাবে অন安全
429অতিরিক্ত আপলোড
503আপলোড পরিষেবা সাময়িকভাবে অনুপলব্ধ; পরে আবার চেষ্টা করুন