跳转到内容

கோப்புகளை பதிவேற்றவும்

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

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"
}
}

பின்னரே ஆவணம் கோப்பு நூலகத்திற்குள் சென்று, பணிகளுக்குப் பயன்படுத்தத் தயாராகும்.

கோப்புப் பெயர்கள்

Section titled “கோப்புப் பெயர்கள்”

filename என்பது காட்சிக்காக மட்டுமே; இதை பாதையாகவோ அல்லது தனித்துவ அடையாளமாகவோ பயன்படுத்த வேண்டாம். சட்டவிரோத எழுத்துக்களை சர்வர் மாற்றி, நீளம் அதிகமான பெயர்களுக்கு பாதுகாப்பான பதிவிறக்கப் பெயரை உருவாக்குகிறது.

நிலைகாரணம்
400செல்லாத கோப்புப் பெயர் அல்லது அளவு, அல்லது பதிவேற்றப்பட்ட அளவு கோரப்பட்ட அளவை விட வேறுபடுகிறது
401சான்றிதழ் அல்லது finalize_token செல்லாதது அல்லது காலாவதி
403finalize_token வேறு ஒரு கணக்கிற்குச் சொந்தமானது
410பதிவேற்றப்பட்ட கோப்பு கிடைக்கவில்லை (இடமாற்றம் முழுமையடையவில்லை அல்லது முகவரி காலாவதியாகிவிட்டது); புதிய முகவரியைக் கோரவும்
413கோப்பு அளவு வரம்பை மீறுகிறது
415ஆதரிக்கப்படாத வடிவம், அல்லது உள்ளடக்கம் நீட்டிப்புடன் பொருந்தவில்லை
422Office கோப்பு சேதமடைந்த அல்லது கட்டமைப்பு ரீதியாக பாதுகாப்பற்றது
429மிகுதியான பதிவேற்றங்கள்
503பதிவேற்ற சேவை தற்காலிகமாகக் கிடைக்கவில்லை; பின்னர் மீண்டும் முயற்சிக்கவும்