跳转到内容

फाइल्स अपलोड करा

अपलोड करण्यासाठी तीन पायऱ्या आहेत: अपलोड पत्ता मागवा, फाइल पाठवा आणि दस्तऐवजाची पुष्टी करा. एकदा लिहिलेला अपलोड पत्ता १ तासापर्यंत वैध असतो.

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
}

Send a PUT to upload_url with the raw file bytes as the body, and send every header in upload_headers exactly as given.

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अपलोड सेवा तात्पुरती अनुपलब्ध आहे; कृपया नंतर प्रयत्न करा