Stažení podepsaného dokumentu

Podepsaný dokument si stáhnete jedním voláním:

curl -H "x-api-key: VAS_API_KLIC" -o podepsany.pdf \
  https://api.signi.com/api/v1/contract/ID_DOKUMENTU/download

Kdy co dostanete

• Dokument ve stavu completed — PDF se všemi podpisy, pečetěmi a časovým razítkem.
• Dokument před dokončením — aktuální podobu PDF bez podpisů. Že jde o nepodepsanou verzi, poznáte i podle velikosti (podepsané PDF je výrazně větší).
• Dokument uložený v archivu Signi — místo PDF se vrátí soubor ZIP s dokumentem, certifikáty a časovými razítky. Pokud chcete i pro archivovaný dokument jen PDF, přidejte ?ignoreArchive=true.

Kdy je dokument dokončený, poznáte podle stavu — viz Životní cyklus dokumentu. Nejpohodlnější je nechat si dokončení ohlásit webhookem — v jeho datech přijde i dočasný odkaz ke stažení souboru.

Kontrolní list

Ke každému dokončenému dokumentu Signi vede kontrolní list (auditní záznam průběhu podepisování). Odkaz na jeho PDF získáte:

curl -X POST -H "x-api-key: VAS_API_KLIC" \
  https://api.signi.com/api/v1/contract/revisionList/link \
  -F "contract_id=ID_DOKUMENTU"

{ "url": "https://…(odkaz na PDF kontrolního listu)…" }

Funguje jen pro dokončené dokumenty — a chvíli po dokončení (kontrolní list se generuje na pozadí, počítejte s ~minutou).

Přílohy se stahují zvlášť

Každá příloha dokumentu má vlastní ID (viz Dokument s přílohami) — stáhnete ji stejným voláním s ID přílohy.

Kam dál

• Životní cyklus dokumentu
• Webhooky — automatická hlášení změn stavu dokumentu