Přeskočit na obsah

Nahrát soubory

Nahrávání probíhá ve třech krocích: vyžádání adresy pro nahrávání, odeslání souboru a potvrzení dokumentu. Adresa pro nahrávání může být zapsána jednou a platí až 1 hodinu.

POST /api/v1/upload/presign
X-API-Key: sk_your_key
Content-Type: application/json
{
"filename": "report.docx",
"file_size": 45678
}
PolíčkoTypVyžadovánoPopis
filenameřetězec✅Název souboru; server určí typ souboru podle přípony
file_sizecelé číslo✅Přesná velikost v bajtech, větší než 0
mime_typeřetězec—Volitelné; server jej nepoužívá

Odpověď:

{
"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
}

Odešlete PUT do upload_url s nezpracovanými byty souboru jako tělem a odešlete každý záhlaví v upload_headers přesně tak, jak je uvedeno.

Terminál
# 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"

Veškeré OmniDoc API klíče v tomto kroku neposílejte. Pokud adresa vyprší nebo přenos selže, požádejte o novou.

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

V případě úspěchu je vrácen dokument:

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

Teprve po potvrzení se dokument dostane do knihovny souborů a stane se použitelným pro úlohy.

filename slouží pouze k zobrazení; nepoužívejte ho jako cestu nebo unikátní identifikátor. Server nahradí neplatné znaky a vygeneruje bezpečný název pro stažení u názvů, které jsou příliš dlouhé.

StavPříčina
400Neplatný název nebo velikost souboru, nebo se nahraná velikost liší od požadované.
401Přihlašovací údaje nebo finalize_token jsou neplatné nebo vypršely
403finalize_token patří k jinému účtu
410Nenašel se nahrávaný soubor (přenos neúplný nebo adresa vypršela); požádejte o novou adresu
413Překračuje limit velikosti souboru
415Nepodporovaný formát nebo obsah neodpovídá příponě.
422Soubor Office je poškozený nebo konstrukčně nestabilní.
429Příliš mnoho nahrávek
503Služba pro nahrávání je dočasně nedostupná; zkuste to později