Generování podpisové doložky

Pro generování podpisové doložky je nutné zavolat koncový bod GraphQL API s dotazem pro generování podpisové doložky, které předáme identifikátor dokumentu a požadované formáty doložky. Výsledkem budou vygenerované podpisové doložky v Base64 nebo zpráva o chybě vzniklé při jejím generování (např. v případě, že dokument žádné podpisy neobsahuje). Možné formáty podpisové doložky jsou PDF, XML a HTML. Ve výstupu jsou vyplněny pouze formáty, o které bylo zažádáno.

Koncový bod: /api/sofa/v1/graphql

Metoda: POST

Hlavičky:

  • Accept: application/json

  • Authorization: Bearer <token>

  • Content-Type: application/json

GraphQL operace:

query generateSignReport(
  $fileId: File_Id!
  $formats: [SignReportFormat]!
) {
  signing {
    generateSignReport(file: $fileId, reportFormat: $formats) {
      hTMLReport
      pDFReport
      xMLReport
      message
    }
  }
}

Příklad:

POST /api/sofa/v1/graphql HTTP/1.1
Host: sofaws.602.cz
Accept: application/json
Authorization: Bearer eyJhbGciOiJBMjU2…
Content-Length: 813
Content-Type: application/json
{
  "operationName": "generateSignReport",
  "query": "query generateSignReport(\n  $fileId:…",
  "variables": {
     "fileId": "eyJhbGciOiJIUzI1…",
     "formats": ["HTML", "PDF", "XML"]
  }
}

Výsledek:

{
  "data": {
    "signing": {
      "generateSignReport": {
        "hTMLReport": "OiJBMjU2S1ciLCJlbmMiOi…",
        "pDFReport": "OiJBMjU2S1ciLCJlbmMiOi…",
        "xMLReport": "OiJBMjU2S1ciLCJlbmMiOi…",
        "message": ""
      }
    }
  }
}