跳转到内容

ಕಡತಗಳನ್ನು ಅಪ್‌ಲೋಡ್ ಮಾಡಿ

ಅಪ್‌ಲೋಡ್ ಮಾಡಲು ಮೂರು ಹಂತಗಳಿವೆ: ಅಪ್‌ಲೋಡ್ ವಿಳಾಸಕ್ಕಾಗಿ ವಿನಂತಿಸುವುದು, ಫೈಲ್ ಕಳುಹಿಸುವುದು ಮತ್ತು ದಾಖಲೆಯನ್ನು ದೃಢೀಕರಿಸುವುದು. ಒಮ್ಮೆ ಬರೆದ ಅಪ್‌ಲೋಡ್ ವಿಳಾಸವು 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
}
ಕ್ಷೇತ್ರಪ್ರಕಾರಅವಶ್ಯಕವಿವರಣೆ
filenamestring✅ಫೈಲ್ ಹೆಸರು; ಸರ್ವರ್ ವಿಸ್ತರಣೆಯಿಂದ ಫೈಲ್ ಪ್ರಕಾರವನ್ನು ನಿರ್ಧರಿಸುತ್ತದೆ
file_sizeಪೂರ್ಣಾಂಕ✅ಬೈಟ್‌ಗಳಲ್ಲಿ ನಿಖರವಾದ ಗಾತ್ರ, 0ಕ್ಕಿಂತ ಹೆಚ್ಚು
mime_typestring—ಐಚ್ಛಿಕ; ಸರ್ವರ್ ಇದನ್ನು ಬಳಸುವುದಿಲ್ಲ

ಪ್ರತಿಕ್ರಿಯೆ:

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

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ಅಪ್‌ಲೋಡ್ ಸೇವೆ ತಾತ್ಕಾಲಿಕವಾಗಿ ಲಭ್ಯವಿಲ್ಲ; ನಂತರ ಮತ್ತೊಮ್ಮೆ ಪ್ರಯತ್ನಿಸಿ