Otpremite datoteke
Otpremanje se vrši u tri koraka: zatražite adresu za otpremanje, pošaljite datoteku i potvrdite dokument. Adresa za otpremanje može se napisati jednom i važi do 1 čas.
1. Zatražite adresu za otpremanje
Section titled “1. Zatražite adresu za otpremanje”POST /api/v1/upload/presignX-API-Key: sk_your_keyContent-Type: application/json{ "filename": "report.docx", "file_size": 45678}| Polje | Tip | Potrebno | Opis |
|---|---|---|---|
filename | niza | ✅ | Ime datoteke; server određuje tip datoteke na osnovu ekstenzije |
file_size | celi broj | ✅ | Tačna veličina u bajtovima, veća od 0 |
mime_type | niza | — | Opciono; server ga ne koristi |
Odgovor:
{ "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. Pošaljite datoteku
Section titled “2. Pošaljite datoteku”Pošaljite PUT na upload_url sa neobrađenim bajtovima datoteke kao telom, i pošaljite svaki zaglavlje u upload_headers tačno onako kako je navedeno.
# 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"Ne šaljite svoj OmniDoc API ključ u ovom koraku. Ako adresa istekne ili prenos ne uspije, zatražite novu.
3. Potvrdite dokument
Section titled “3. Potvrdite dokument”POST /api/v1/upload/finalizeX-API-Key: sk_your_keyContent-Type: application/json{"finalize_token":"short_lived_token"}U slučaju uspeha, dokument se vraća:
{ "document": { "id": "4q8mx2q9z1k7p6ra", "basename": "report.docx", "file_size": 45678, "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "created_at": "2026-10-01T12:00:00Z" }}Tek nakon potvrde dokument ulazi u biblioteku datoteka i postaje dostupan za rad.
Imena datoteka
Section titled “Imena datoteka”filename je samo za prikaz; ne koristite ga kao putanju ili jedinstveni identifikator. Server zamenjuje nelegalne znakove i generiše bezbedno ime za preuzimanje za imena koja su predugačka.
Greške
Section titled “Greške”| Status | Uzrok |
|---|---|
400 | Nedopušteno ime ili veličina datoteke, ili se otpremljena veličina razlikuje od zahtevane |
401 | Poverljivi podaci ili finalize_token su nevalidni ili istekli |
403 | finalize_token pripada drugom nalogu |
410 | Ne može da se pronađe otpremljena datoteka (prenos je nepotpun ili je adresa istekla); zatražite novu adresu |
413 | Prekoračen limit veličine po datoteci |
415 | Nepodržan format ili sadržaj se ne poklapa sa ekstenzijom |
422 | Datoteka Office je oštećena ili strukturno nesigurna |
429 | Previše preuzimanja |
503 | Usluga otpremanja je privremeno nedostupna; pokušajte kasnije |