Vyhodnocení chyb

Http status

Pokud služba neprovede požadavek, protože vstup je neplatný, vrací http stav 400. To se děje i v případě, že požadavek je ve správném json formátu, ale podpisy dokumentu nejsou platné.

Neplatný formát souboru

Služba vrátí v:

/errors/0/extensions/code

+ hodnotu ERROR_DOC_UPDATE_VALIDATION,

a v:

/errors/0/extensions/data/validationErrors/0/meta/0/errors/0/code

hodnotu PKI8002

{
  "errors": [
    {
      "message": "Soubory nelze aktualizovat, vstupní hodnoty nejsou validní.",
      "locations": [
        {
          "line": 4,
          "column": 7
        }
      ],
      "path": [
        "docs",
        "files",
        "createObecny_dokumentBatch"
      ],
      "extensions": {
        "code": "ERROR_DOC_UPDATE_VALIDATION",
        "codes": [
          "ERROR_DOC_UPDATE_VALIDATION"
        ],
        "data": {
          "validationErrors": [
            {
              "index": 0,
              "id": "a6ba8964-9a6b-48d5-bb12-cc402f48d0e1",
              "meta": [
                {
                  "id": "sys_currentBlob",
                  "errors": [
                    {
                      "message": "Nepodepsaný soubor. Kód chyby je 1841167527.",
                      "code": PKI8002
                    }
                  ]
                }
              ]
            }
          ]
        }
      }
    }
  ],
  "data": {
    "docs": {
      "files": {
        "createObecny_dokumentBatch": [
          null
        ]
      }
    }
  }
}

Nepodepsaný dokument

Služba vrátí v:

/errors/0/extensions/code

hodnotu ERROR_DOC_UPDATE_VALIDATION,

a v:

/errors/0/extensions/data/validationErrors/0/meta/0/errors/0/code

hodnotu PKI8023

Neplatné podpisy na dokumentu

Služba vrátí v:

/errors/0/extensions/code

hodnotu ERROR_DOC_UPDATE_VALIDATION,

a v:

/errors/0/extensions/data/validationErrors/0/meta/0/errors/0/code

hodnotu: ERROR_INVALID_SIGNATURES

Dočasná chyba při ověření podpisů

Služba vrátí v:

/errors/0/extensions/code

hodnotu: ERROR_DOC_UPDATE_VALIDATION,

a v:

/errors/0/extensions/data/validationErrors/0/meta/0/errors/0/code

hodnotu: ERROR_TRY_LATER

Tato chyba může nastat např. při neaktuálním crl a nedostupnosti ocsp pro ověření nerevokace certifikátu podpisu nebo razítka.

Dočasné chyby

Všechny ostatní chyby, než výše jmenované je nutno interpretovat jako dočasnou chybu s tím, že je nutné volání opakovat s rozumně definovaným časovým odstupem. Validace je závislá na externích zdrojích certifikačních autorit a také na provozované infrastruktuře.