跳转到内容

Otpremite datoteke

Prijam podataka obavlja se u tri koraka: zatražite adresu za prijem, pošaljete datoteku i potvrdite dokument. Adresa za prijem može se napisati jednom i vrijedi do 1 sat.

POST /api/v1/upload/presign
X-API-Key: sk_your_key
Content-Type: application/json
{
"filename": "report.docx",
"file_size": 45678
}
PoljeVrstaPotrebnoOpis
filenameniz✅Ime datoteke; poslužitelj određuje vrstu datoteke na temelju nastavka
file_sizecijeli broj✅Točna veličina u bajtovima, veća od 0
mime_typeniz—Neobavezno; poslužitelj 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 s bajtovima izvorne datoteke kao tijelom, i pošaljite svaki zaglavlje u upload_headers toč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"

U ovom koraku ne šaljite svoj OmniDoc API ključ. Ako adresa istekne ili prijenos 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 uspjeha 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 knjižnicu datoteka i postaje dostupan za rad.

filename služi samo za prikaz; ne koristite ga kao putanju ili jedinstveni identifikator. Server zamjenjuje nelegalne znakove i generira sigurno ime za preuzimanje za imena koja su preduga.

StatusUzrok
400Nevaljano ime ili veličina datoteke, ili se preuzeta veličina razlikuje od tražene
401Vjerodajnica ili finalize_token nije valjana ili je istekla
403finalize_token pripada drugom računu
410Odgovarajući otplaničeni fajl nije pronađen (prijenos je nepotpun ili adresa je istekla); zatražite novu adresu
413Prekoračen je ograničenje veličine po datoteci
415Nepodržan format ili sadržaj ne odgovara datoteci.
422Datoteka Office je oštećena ili konstrukcijski nestabilna
429Pretjerano mnogo preuzimanja
503Usluga učitavanja privremeno nije dostupna; pokušajte ponovno kasnije