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.
1. Požádejte o adresu pro nahrávání
Section titled “1. Požádejte o adresu pro nahrávání”POST /api/v1/upload/presignX-API-Key: sk_your_keyContent-Type: application/json{ "filename": "report.docx", "file_size": 45678}| Políčko | Typ | Vyžadováno | Popis |
|---|---|---|---|
filename | řetězec | ✅ | Název souboru; server určí typ souboru podle přípony |
file_size | celé čí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}2. Odešlete soubor
Section titled “2. Odešlete soubor”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.
# 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"Veškeré OmniDoc API klíče v tomto kroku neposílejte. Pokud adresa vyprší nebo přenos selže, požádejte o novou.
3. Potvrďte dokument
Section titled “3. Potvrďte dokument”POST /api/v1/upload/finalizeX-API-Key: sk_your_keyContent-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.
Názvy souborů
Section titled “Názvy souborů”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é.
| Stav | Příčina |
|---|---|
400 | Neplatný název nebo velikost souboru, nebo se nahraná velikost liší od požadované. |
401 | Přihlašovací údaje nebo finalize_token jsou neplatné nebo vypršely |
403 | finalize_token patří k jinému účtu |
410 | Nenašel se nahrávaný soubor (přenos neúplný nebo adresa vypršela); požádejte o novou adresu |
413 | Překračuje limit velikosti souboru |
415 | Nepodporovaný formát nebo obsah neodpovídá příponě. |
422 | Soubor Office je poškozený nebo konstrukčně nestabilní. |
429 | Příliš mnoho nahrávek |
503 | Služba pro nahrávání je dočasně nedostupná; zkuste to později |