Stažení PDF z odkazu ve webhooku

Když vám webhook ohlásí změnu stavu dokumentu, přijde v něm i pole file — hotový odkaz ke stažení PDF:

{
    "contract_id": 1234567,
    "state": "completed",
    "file": "https://api.signi.com/api/v1/contract/pdf/preview?hash=…",
    "attachments": [
        { "contract_id": 1234568, "state": "completed", "file": "https://api.signi.com/api/v1/contract/pdf/preview?hash=…" }
    ]
}

Stačí zavolat GET na tuto adresu a vrátí se PDF:

curl -o dokument.pdf "https://api.signi.com/api/v1/contract/pdf/preview?hash=…"

Co je dobré vědět

• Odkaz platí 10 minut. Hash je vygenerovaný jen pro tento webhook — soubor stáhněte hned po přijetí.
• API klíč není potřeba — odkaz funguje sám o sobě. Zacházejte s ním proto jako s citlivým údajem.
• Po vypršení odkazu vrátí volání chybu — pak použijte běžné stažení přes API, to funguje kdykoli.
• Každá příloha má ve webhooku vlastní odkaz.

Kam dál

• Webhooky — automatická hlášení změn stavu dokumentu
• Stažení podepsaného dokumentu