ഫയലുകൾ അപ്ലോഡ് ചെയ്യുക
അപ്ലോഡ് ചെയ്യുന്നതിന് മൂന്ന് ഘട്ടങ്ങളുണ്ട്: ഒരു അപ്ലോഡ് വിലാസം അഭ്യർത്ഥിക്കുക, ഫയൽ അയയ്ക്കുക, പ്രമാണം സ്ഥിരീകരിക്കുക. ഒരു അപ്ലോഡ് വിലാസം ഒരിക്കൽ എഴുതാം, 1 മണിക്കൂർ വരെ സാധുതയുണ്ട്.
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. ഫയൽ അയയ്ക്കുക”റോ ഫയൽ ബൈറ്റുകൾ ബോഡിയായി ഉപയോഗിച്ച് upload_url എന്നതിലേക്ക് ഒരു PUT അയയ്ക്കുക, കൂടാതെ 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 | അപ്ലോഡ് സേവനം താൽക്കാലികമായി ലഭ്യമല്ല; പിന്നീട് വീണ്ടും ശ്രമിക്കുക |