跳转到内容

ഫയലുകൾ അപ്‌ലോഡ് ചെയ്യുക

അപ്‌ലോഡ് ചെയ്യുന്നതിന് മൂന്ന് ഘട്ടങ്ങളുണ്ട്: ഒരു അപ്‌ലോഡ് വിലാസം അഭ്യർത്ഥിക്കുക, ഫയൽ അയയ്ക്കുക, പ്രമാണം സ്ഥിരീകരിക്കുക. ഒരു അപ്‌ലോഡ് വിലാസം ഒരിക്കൽ എഴുതാം, 1 മണിക്കൂർ വരെ സാധുതയുണ്ട്.

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
}

റോ ഫയൽ ബൈറ്റുകൾ ബോഡിയായി ഉപയോഗിച്ച് upload_url എന്നതിലേക്ക് ഒരു PUT അയയ്‌ക്കുക, കൂടാതെ 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"
}
}

സ്ഥിരീകരണത്തിനു ശേഷം മാത്രമേ പ്രമാണം ഫയൽ ലൈബ്രറിയിൽ പ്രവേശിക്കുകയും ജോലികൾക്കായി ഉപയോഗിക്കുകയും ചെയ്യും.

ഫയലുകളുടെ പേരുകൾ

Section titled “ഫയലുകളുടെ പേരുകൾ”

filename പ്രദർശനത്തിന് മാത്രമുള്ളതാണ്; ഇത് ഒരു പാതയായോ തനതായ ഐഡൻ്റിഫയറായോ ഉപയോഗിക്കരുത്. സെർവർ നിയമവിരുദ്ധമായ പ്രതീകങ്ങൾ മാറ്റിസ്ഥാപിക്കുകയും ദൈർഘ്യമേറിയ പേരുകൾക്ക് സുരക്ഷിതമായ ഡൗൺലോഡ് നാമം സൃഷ്ടിക്കുകയും ചെയ്യുന്നു.

നിലകാരണം
400ഫയലിൻ്റെ പേരോ വലുപ്പമോ അസാധുവാണ്, അല്ലെങ്കിൽ അപ്‌ലോഡ് ചെയ്ത വലുപ്പം അഭ്യർത്ഥിച്ചതിൽ നിന്ന് വ്യത്യസ്തമാണ്
401ക്രെഡൻഷ്യൽ അല്ലെങ്കിൽ finalize_token അസാധുവാണ് അല്ലെങ്കിൽ കാലഹരണപ്പെട്ടു
403finalize_token മറ്റൊരു അക്കൗണ്ടിൻ്റെതാണ്
410അപ്‌ലോഡ് ചെയ്ത ഫയൽ കണ്ടെത്തിയില്ല (കൈമാറ്റം അപൂർണ്ണമാണ് അല്ലെങ്കിൽ വിലാസം കാലഹരണപ്പെട്ടു); ഒരു പുതിയ വിലാസം അഭ്യർത്ഥിക്കുക
413ഓരോ ഫയലിൻ്റെയും വലുപ്പ പരിധി കവിയുന്നു
415പിന്തുണയ്ക്കാത്ത ഫോർമാറ്റ്, അല്ലെങ്കിൽ ഉള്ളടക്കം വിപുലീകരണവുമായി പൊരുത്തപ്പെടുന്നില്ല
422Office ഫയൽ കേടായതോ ഘടനാപരമായി സുരക്ഷിതമല്ലാത്തതോ ആണ്
429വളരെയധികം അപ്‌ലോഡുകൾ
503അപ്‌ലോഡ് സേവനം താൽക്കാലികമായി ലഭ്യമല്ല; പിന്നീട് വീണ്ടും ശ്രമിക്കുക