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.
1. Zatražite adresu za preuzimanje
Section titled “1. Zatražite adresu za preuzimanje”POST /api/v1/upload/presignX-API-Key: sk_your_keyContent-Type: application/json{ "filename": "report.docx", "file_size": 45678}| Polje | Vrsta | Potrebno | Opis |
|---|---|---|---|
filename | niz | ✅ | Ime datoteke; poslužitelj određuje vrstu datoteke na temelju nastavka |
file_size | cijeli broj | ✅ | Točna veličina u bajtovima, veća od 0 |
mime_type | niz | — | 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}2. Pošaljite datoteku
Section titled “2. Pošaljite datoteku”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.
# 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"U ovom koraku ne šaljite svoj OmniDoc API ključ. Ako adresa istekne ili prijenos 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 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.
Imena datoteka
Section titled “Imena datoteka”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.
Greške
Section titled “Greške”| Status | Uzrok |
|---|---|
400 | Nevaljano ime ili veličina datoteke, ili se preuzeta veličina razlikuje od tražene |
401 | Vjerodajnica ili finalize_token nije valjana ili je istekla |
403 | finalize_token pripada drugom računu |
410 | Odgovarajući otplaničeni fajl nije pronađen (prijenos je nepotpun ili adresa je istekla); zatražite novu adresu |
413 | Prekoračen je ograničenje veličine po datoteci |
415 | Nepodržan format ili sadržaj ne odgovara datoteci. |
422 | Datoteka Office je oštećena ili konstrukcijski nestabilna |
429 | Pretjerano mnogo preuzimanja |
503 | Usluga učitavanja privremeno nije dostupna; pokušajte ponovno kasnije |