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.
1. Požiadajte o adresu na nahrávanie
Section titled “1. Požiadajte o adresu na nahrávanie”POST /api/v1/upload/presignX-API-Key: sk_your_keyContent-Type: application/json{ "filename": "report.docx", "file_size": 45678}| Políčko | Typ | Požadované | Popis |
|---|---|---|---|
filename | reťazec | ✅ | Meno súboru; server určí typ súboru na základe prípony |
file_size | celé číslo | ✅ | Presná veľkosť v bajtoch, väčšia ako 0 |
mime_type | reť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}2. Pošlite súbor
Section titled “2. Pošlite súbor”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ý.
# 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"V tomto kroku neposielajte svoj OmniDoc API kľúč. Ak adresa vyprší alebo prenos zlyhá, požiadajte o novú.
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 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.
Menná značka súboru
Section titled “Menná značka súboru”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é.
| Stav | Príčina |
|---|---|
400 | Neplatný názov súboru alebo veľkosť, alebo sa nahratá veľkosť líši od požadovanej. |
401 | Poverenie alebo finalize_token je neplatné alebo vypršalo |
403 | finalize_token patrí k inému účtu |
410 | Nahraný súbor bol nenájdený (prenos nebol dokončený alebo adresa vypršala); požiadajte o novú adresu. |
413 | Prekročil limit veľkosti súboru |
415 | Nepodporovaný formát alebo obsah nezodpovedá príponke. |
422 | Súbor Office je poškodený alebo štrukturálne nebezpečný. |
429 | Príliš veľa nahrávaní |
503 | Služba na nahrávanie je dočasne nedostupná; skúste to neskôr. |