फाइल्स अपलोड करा
अपलोड करण्यासाठी तीन पायऱ्या आहेत: अपलोड पत्ता मागवा, फाइल पाठवा आणि दस्तऐवजाची पुष्टी करा. एकदा लिहिलेला अपलोड पत्ता १ तासापर्यंत वैध असतो.
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. फाइल पाठवा”Send a PUT to upload_url with the raw file bytes as the body, and send every header in upload_headers exactly as given.
# 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 | अपलोड सेवा तात्पुरती अनुपलब्ध आहे; कृपया नंतर प्रयत्न करा |