Preskočiť na obsah

Nahrajte súbory

Nahranie prebieha v troch krokoch: požiadanie o adresu na nahrávanie, odoslanie súboru a potvrdenie dokumentu. Adresa na nahrávanie sa dá vygenerovať raz a je platná maximálne 1 hodinu.

POST /api/v1/upload/presign
X-API-Key: sk_your_key
Content-Type: application/json
{
"filename": "report.docx",
"file_size": 45678
}
PolíčkoTypPožadovanéPopis
filenamereťazec✅Meno súboru; server určí typ súboru na základe prípony
file_sizecelé číslo✅Presná veľkosť v bajtoch, väčšia ako 0
mime_typereťazec—Voliteľné; server ho nepoužíva

Odpoveď:

{
"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šlite PUT na upload_url s neupravenými bajtmi zo súboru ako telom a pošlite každý hlavičkový riadok v upload_headers presne tak, ako je uvedený.

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"

V tomto kroku neposielajte svoj OmniDoc API kľúč. Ak adresa vyprší alebo prenos zlyhá, požiadajte o novú.

POST /api/v1/upload/finalize
X-API-Key: sk_your_key
Content-Type: application/json
{"finalize_token":"short_lived_token"}

V prípade úspechu je dokument vrátený:

{
"document": {
"id": "4q8mx2q9z1k7p6ra",
"basename": "report.docx",
"file_size": 45678,
"mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"created_at": "2026-10-01T12:00:00Z"
}
}

Až po potvrdení sa dokument dostane do knižnice súborov a stane sa použiteľným pre úlohy.

filename slúži iba na zobrazenie; nepoužívajte ho ako cestu alebo jedinečný identifikátor. Server nahradí nelegálne znaky a vygeneruje bezpečný názov súboru na stiahnutie pre názvy, ktoré sú príliš dlhé.

StavPríčina
400Neplatný názov súboru alebo veľkosť, alebo sa nahratá veľkosť líši od požadovanej.
401Poverenie alebo finalize_token je neplatné alebo vypršalo
403finalize_token patrí k inému účtu
410Nahraný súbor bol nenájdený (prenos nebol dokončený alebo adresa vypršala); požiadajte o novú adresu.
413Prekročil limit veľkosti súboru
415Nepodporovaný formát alebo obsah nezodpovedá príponke.
422Súbor Office je poškodený alebo štrukturálne nebezpečný.
429Príliš veľa nahrávaní
503Služba na nahrávanie je dočasne nedostupná; skúste to neskôr.