Výsledky podepisování

• Jak získat výsledky podepisování?  
  • 1. Dvousměrná integrace s vyvoláním zpětného webhooku
  • 2. Jednosměrná integrace s průběžným ověřováním stavu 
• V jakém formátu se předávají výsledné dokumenty? 

Jak získat výsledky podepisování?  

Jsou 2 možné cesty získání výsledků ze Signi:

• dvousměrná integrace s vyvoláním zpětných webhooků,

• jednosměrná integrace s průběžným ověřováním stavu.

1. Dvousměrná integrace s vyvoláním zpětného webhooku

• Součástí předávání podkladů pro podpis jsou i 3 URL adresy tzv. “webhooků” pro každou hodnotu výsledku:

  • podepsáno - signed,

  • odmítnuto  - rejected,

  • neověřeno - expired.

• viz např. úvodní část JSON:

{
    "contract_name": "Dokument s webhooky",
    "number": "000001",
    "state": "pending",
    "locale": "cs",
    "settings": {
        "signing_order": "proposers_before_counterparties"
    },
    "webhooks": [
        {
            "state": "completed",
            "url": "http://example.com/?source=signi&constract_id=1234&state=completed"
        },
        {
            "state": "rejected",
            "url": "http://example.com/?source=signi&constract_id=1234&state=rejected"
        },
        {
            "state": "expired",
            "url": "http://example.com/?source=signi&constract_id=1234&state=expired"
        }        
    ],
    ....
    další části JSON
}

• URL adresy typicky obsahují volání integrované aplikace. 

• Zavolán je vždy jen jeden webhook z těchto tří podle výsledku. Pokud se parametr url ponechá prázdný, web hook se nevyvolá.

• Ve vzoru volání na https://app.swaggerhub.com/apis-docs/Signi/Signi/1.3.3/#/Contract/post_api_v1_contract_ je třeba text “your_webhook_url\” nahradit reálnou URL.

• Nyní se volá webhook pro každý dokument zvlášť včetně příloh.

• Výsledný podepsaný dokument se do integrované aplikace při vyvolání webhooku předává následovně:

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