கோப்புகளை பதிவேற்றவும்
பதிவேற்றம் மூன்று படிகளைக் கொண்டது: ஒரு பதிவேற்ற முகவரியைக் கோருதல், கோப்பை அனுப்புதல், ஆவணத்தை உறுதிப்படுத்துதல். ஒரு பதிவேற்ற முகவரி ஒருமுறை உருவாக்கப்பட்டு 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. கோப்பை அனுப்பவும்”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 | பதிவேற்ற சேவை தற்காலிகமாகக் கிடைக்கவில்லை; பின்னர் மீண்டும் முயற்சிக்கவும் |