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