跳转到内容

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.

POST /api/v1/upload/presign
X-API-Key: sk_your_key
Content-Type: application/json
{
"filename": "report.docx",
"file_size": 45678
}
PoljeTipPotrebnoOpis
filenameniza✅Ime datoteke; server određuje tip datoteke na osnovu ekstenzije
file_sizeceli broj✅Tačna veličina u bajtovima, veća od 0
mime_typeniza—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
}

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.

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"

Ne šaljite svoj OmniDoc API ključ u ovom koraku. Ako adresa istekne ili prenos ne uspije, zatražite novu.

POST /api/v1/upload/finalize
X-API-Key: sk_your_key
Content-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.

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.

StatusUzrok
400Nedopušteno ime ili veličina datoteke, ili se otpremljena veličina razlikuje od zahtevane
401Poverljivi podaci ili finalize_token su nevalidni ili istekli
403finalize_token pripada drugom nalogu
410Ne može da se pronađe otpremljena datoteka (prenos je nepotpun ili je adresa istekla); zatražite novu adresu
413Prekoračen limit veličine po datoteci
415Nepodržan format ili sadržaj se ne poklapa sa ekstenzijom
422Datoteka Office je oštećena ili strukturno nesigurna
429Previše preuzimanja
503Usluga otpremanja je privremeno nedostupna; pokušajte kasnije