Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Запит служить для отримання результату перевірки ЕП. Запит є блокуючим, то результат буде отримано лише після завершення процесу перевірки ЕП, якщо такий був раніше запущено. Якщо ЕП дійсна, то буде повернуто HTTP статус код 200. Якщо ЕП не дійсний чи у процесі її безпосередньої перевірки виникають помилки, буде повернуто HTTP статус код 406. При появі інших типів помилок, повертаються HTTP статус коди 503 чи 400.

URL-адреса запиту

https://ccs-dev-api.cipher.kiev.ua/ccs

Запрос служит для получения результата проверки ЭП. Запрос является блокирующим, то есть результат будет получен только после завершения процесса проверки ЭП, если такой был ранее запущен. Если ЭП действительна, будет возвращен HTTP статус код 200. Если в ЭП недействительна или в процессе ее непосредственной проверки возникли ошибки, будет возвращен HTTP статус код 406. При возникновении других типов ошибок, возвращаются HTTP статус коды 503 или 400.

URL-адрес запроса

https://localhost:9094/api/v1/ticket/{uuid}/ds/verifier

Метод

GET

...

Параметри запиту
uuidStringИдентификатор сессииІдентифікатор сесії

...

Налаштовувані заголовки

...

запиту

ОтсутствуетВідсутні

...

Відповідь
Код ответавідповідіContent-typeДопустимые параметрыДопустимі параметриПриклад вмістуПример содержимого
200application/jsonmessage
verifyResults 
{
"message" : "ЭлектроннаяЕлектронний подписьпідпис действительнадійсний.",
"verifyResults" : Array
}
503application/jsonmessage
{
       "message" : "СервисСервіс выполнениявиконання криптографическихкриптографічних операцийоперацій не запущензапущено."
}
400application/jsonmessage
{
       "message" : "СессияСесія отсутствуетвідсутня."
}
406application/jsonmessage
verifyResults
failureCause
{
       "message" : "ЭлектроннаяЕлектронний подписьпідпис не действительнадійсний.",
"failureCause" : "",
"verifyResults" : Array
}

...

Параметри JSON

...

обʼєкта відповіді
ПараметрТип данныхданихОписаниеОпис
messageStringОписание результата проведения операцииОпис результату проведення операції
failureCause StringОписание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭПОпис причини виникнення помилки, яка виникла при виконанні запиту на перевірку ЕП
verifyResultsArrayРезультаты проверки отдельно по каждой из ЭПРезультати перевірки окремо по кожній з ЕП

Поля елемента масиву Поля элемента массива verifyResults

проверка ЭП произведена без ошибок процессе проверки ЭП возникли ошибкиОписание причины возникновения ошибки, которая возникла при непосредственной проверке ЭПИнформация из сертификата владельца ЭПВремя создания ЭП ЭП действительна ЭП недействительна проверки электронной метки (ЭМВ) времени данных, для которых была создана ЭПРезультаты проверки электронных меток времени электронной подписи проверки подписи использовалось время создания подписи, которое не заверено электронной меткой времени ЭП действительна ЭП недействительна
ПолеТип данныхданихОписаниеОпис
statusString"SUCCESS" - перевірка ЕП здійснена без помилок
"FAILURE" - в
процесі перевірки ЕП виникли помилки
failureCauseStringОпис причини виникнення помилки, яка виникла при безпосередній перевірці ЕП
signerInfoObjectІнформація з сертифіката власника ЕП
signingDateTimeStringЧас створення ЕП
isValidBooleantrue - ЕП дійсний
false -
ЕП не дійсний
contentTimestampObjectРезультат перевірки електронної позначки часу (ЕПЧ) даних для яких було створено ЕП
signatureTimestampsArrayРезультати перевірки ЕПЧ електронного підпису
isUntrustedValidBooleanДля перевірки ЕП використовується час створення ЕП, яке не завірено ЕПЧ.
true -
ЕП дійсна
false -

Поля объекта contentTimestamp, элемента массива signatureTimestamps

...

ЕП не дійсний
signatureTypeString

Тип електронного підпису.
Можливі значення:

  • DETACHED
  • ATTACHED
  • ASIC_S
  • ASIC_E
signatureFormatString

Формат електронного підпису.
Можливі значення:

  • CADES_BES
  • CADES_C
  • CADES_T
  • CADES_X_LONG
  • XADES_B_B
  • XADES_B_T
  • XADES_B_LT
  • XADES_B_LTA

Поля обʼєкта contentTimestamp, елемента масиву signatureTimestamps

ПолеТип данихОпис
isValidBooleantrue - ЕПЧ дійсна
false - ЕПЧ не дійсна
isFailureBooleantrue - при перевірці ЕПЧ виникла помилка
false - при перевірці ЕПЧ помилок не виникло
dateTimeDateTimeЗначення дати та часу у форматі ISO 8601, яке завірено ЕПЧ
tsaCertificateSerialNumberObject*Серійний номер сертифікату TSP-серверу

Поля обʼєкта

Anchor
signerInfo
signerInfo
signerInfo

ПолеТип данихОпис
ownerCertificateInfoObject*Інформація про власника
issuerCertificateInfoObject*Інформація про видавця
publicKeyCertificateInfoObject*Інформація про відкритий ключ
certificateSerialNumberObject*Серійний номер сертифікату
notBeforeObject*Початок дії
notAfterObject*Кінець дії
extensionsCertificateInfoObject*Розширення

Поля обʼєкта

Anchor
ownerCertificateInfo
ownerCertificateInfo
signerInfo.ownerCertificateInfo.value

ПолеТип данихОпис
ownerSurnameObject*Прізвище
ownerGivennameObject*Імʼя по батькові
ownerFullNameObject*Повне імʼя
ownerCountryObject*Країна
ownerRegionObject*Область
ownerCityObject*Населений пункт
ownerAddressObject*Поштова адреса
ownerSerialNumberObject*Серійний номер власника
ownerPositionObject*Посада

Поля обʼєкта 

Anchor
issuerCertificateInfo
issuerCertificateInfo
 signerInfo.issuerCertificateInfo.value

ПолеТип данихОпис
issuerOrganizationObject*Організація
issuerDepartmentObject*Підрозділ
issuerFullNameObject*Повне імʼя
issuerCountryObject*Країна
issuerRegionObject*Область
issuerCityObject*Населений пункт
issuerAddressObject*Поштова адреса
issuerSerialNumberObject*Серійний номер власника

Поля обʼєкта 

Anchor
publicKeyCertificateInfo
publicKeyCertificateInfo
 signerInfo.publicKeyCertificateInfo.value

ПолеТип данихОпис
publicKeyObject*Відкритий ключ
dsAlgorismObject*Алгоритм ЕП

Поля обʼєкта 

Anchor
extensionsCertificateInfo
extensionsCertificateInfo
 signerInfo.extensionsCertificateInfo.value

ПолеТип данихОпис
personalDataObject*Персональні дані
alternativeOwnerNameObject*Альтернативне імʼя власника
subjectKeyIdObject*Ідентифікатор ключа
issuerKeyIdObject*Ідентифікатор ключа видавця
subjectOwnerIdObject*Ідентифікатор власника
certificateProfileObject*Профіль сертифікату
keyUsageObject*Призначення сертифікату
isTemporaryObject*Ознака стартового сертифікату
isReinforcedObject*Ознака посиленого сертифікату
isQualifiedObject*Ознака кваліфікованого сертифікату
isPrivateKeyOnQSCDObject*Ознака засобів КЕП
qscdTypeNameObject*Тип засобів КЕП
isElectronicStampObject*Ознака електронної печатки

Поля обʼєкта 

Anchor
personalData
personalData
 signerInfo.extensionsCertificateInfo.value.personalData.value   

ПолеТип данихОпис
customIdObject*Зовнішній ідентифікатор
passportObject*Паспортні дані
drfouObject*Реєстраційний номер облікової картки платника податків

edrpou

Object*Код ЄДРПОУ

eddrun

Object*

Унікальний номер запиту в ЄДДР

Поля обʼєкта типу

Anchor
CertObject
CertObject
Object* 

ПолеТип данихОпис
descriptionStringОпис поля на мові, який обрано користувачем у Сервісі
value[Object, String, Boolean, Number, Array, null]Значення поля

Приклад обʼєкта signerInfo

Code Block
{
    "message": "Електронний підпис дійсний.",
    "verifyResults

...

ПолеТип данныхОписание
ownerSurnameObject*Фамилия
ownerGivennameObject*Имя отчество
ownerFullNameObject*Полное имя
ownerCountryObject*Страна
ownerRegionObject*Область
ownerCityObject*Город
ownerAddressObject*Почтовый адрес
ownerSerialNumberObject*Серийный номер владельца
ownerPositionObject*Должность

...

edrpou

...

eddrun

...

Уникальный номер записи в ЕГДР

...

Пример объекта signerInfo

Code Block
{
    "message": "Електронний підпис дійсний.",
    "verifyResults": [
        {
            "status": "SUCCESS",
            "failureCause": "",
            "isValid": true,
            "signingDateTime": "2020-03-05T13:25:36Z",
            "contentTimestamp": {},
            "signatureTimestamps": [
                {
                    "isValid"status": true,
        "SUCCESS",
            "isFailurefailureCause": false"",
            "isValid": true,
            "dateTimesigningDateTime": "2020-03-05T13:25:39Z36Z",
            "contentTimestamp": {},
            "tsaCertificateSerialNumbersignatureTimestamps": "3DB73E7BF0D575B20200000001000000BB000000"[
                }{
            ],
        "isValid": true,
   "signerInfo": {
                "ownerCertificateInfoisFailure": {false,
                    "descriptiondateTime": "Власник2020-03-05T13:25:39Z",
                    "valuetsaCertificateSerialNumber": {"3DB73E7BF0D575B20200000001000000BB000000"
                }
           "ownerSurname": { ],
            "signerInfo": {
                "descriptionownerCertificateInfo": "Прізвище",{
                            "value"description": "БоровіковВласник",
                        },"value": {
                        "ownerGivennameownerSurname": {
                            "description": "Імя по-батьковіПрізвище",
                            "value": "Олександр МихайловичБоровіков"
                        },
                        "ownerFullNameownerGivenname": {
                            "description": "Повне ім'яІмя по-батькові",
                            "value": "Боровіков Олександр Михайлович"
                        },
                        "ownerCountryownerFullName": {
                            "description": "КраїнаПовне ім'я",
                            "value": "UAБоровіков Олександр Михайлович"
                        },
                        "ownerRegionownerCountry": {
                            "description": "ОбластьКраїна",
                            "value": null"UA"
                        },
                        "ownerCityownerRegion": {
                            "description": "МістоОбласть",
                            "value": "Київ"null
                        },
                        "ownerAddressownerCity": {
                            "description": "Поштова адресаМісто",
                            "value": null"Київ"
                        },
                        "ownerSerialNumberownerAddress": {
                            "description": "СерійнийПоштова номер власникаадреса",
                            "value": "2423814"null
                        },
                        "ownerPositionownerSerialNumber": {
                            "description": "ПосадаСерійний номер власника",
                            "value": null"2423814"
                        },
                        "ownerOrganizationownerPosition": {
                            "description": "ОрганізаціяПосада",
                            "value": null
                        },
                        "ownerOrganizationUnitownerOrganization": {
                            "description": "Відділ (підрозділ)Організація",
                            "value": null
                        },
                    }
                },
        "ownerOrganizationUnit": {
        "issuerCertificateInfo": {
                    "description": "ВидавникВідділ (підрозділ)",
                            "value": {null
                        "issuerOrganization": {
}
                    }
               "description": "Організація",
 },
                "issuerCertificateInfo": {
                    "valuedescription": "Інформаційно-довідковий департамент ДФС"Видавник",
                        },"value": {
                        "issuerDepartmentissuerOrganization": {
                            "description": "ПідрозділОрганізація",
                            "value": "Управління (центр) сертифікації ключів ІДДІнформаційно-довідковий департамент ДФС"
                        },
                        "issuerFullNameissuerDepartment": {
                            "description": "Повне ім'яПідрозділ",
                            "value": "АкредитованийУправління (центр) сертифікації ключів ІДД ДФС"
                        },
                        "issuerCountryissuerFullName": {
                            "description": "КраїнаПовне ім'я",
                            "value": "UAАкредитований центр сертифікації ключів ІДД ДФС"
                        },
                        "issuerRegionissuerCountry": {
                            "description": "ОбластьКраїна",
                            "value": null"UA"
                        },
                        "issuerCityissuerRegion": {
                            "description": "МістоОбласть",
                            "value": "Київ"null
                        },
                        "issuerAddressissuerCity": {
                            "description": "Поштова адресаМісто",
                            "value": null"Київ"
                        },
                        "issuerSerialNumberissuerAddress": {
                            "description": "СерійнийПоштова номер видавцяадреса",
                            "value": "UA-39384476-2018"
                   "value": null
    }
                    },
                },
        "issuerSerialNumber": {
       "publicKeyCertificateInfo": {
                    "description": "ІнформаціяСерійний прономер відкритий ключвидавця",
                    "value": {
        "value": "UA-39384476-2018"
               "publicKey": {
        }
                    "description": "Відкритий ключ",}
                    },
        "value": "C4 39 B0 5D 95 8A 6D 95 0E 4D F4 71 2A 62 59 6B A1 55 C9 6A 91 99 21 01 8E D3 7B B4 72 11 E6 F9 00""publicKeyCertificateInfo": {
                    "description": "Інформація про відкритий ключ",
                        },"value": {
                        "dsAlgorismpublicKey": {
                            "description": "АлгоритмВідкритий ЕПключ",
                            "value": "ДСТУ 4145-2002, ПБ, little-endian"
                        }
             "C4 39 B0 5D 95 8A 6D 95 0E 4D F4 71 2A 62 59 6B A1 55 C9 6A 91 99 21 01 8E D3 7B B4 72 11 E6 F9 00"
        }
                },
                "certificateSerialNumber": {
            "dsAlgorism": {
       "description": "Серійний номер сертифікату",
                    "valuedescription": "20B4E4ED0D30998C0400000006FC24004DAD7500Алгоритм ЕП",
                },
            "value": "ДСТУ 4145-2002, ПБ, "notBefore": {
little-endian"
                      "description": "Початок дії",}
                    "value": "2019-06-10T21:00:00Z"}
                },
                "notAftercertificateSerialNumber": {
                    "description": "ЗакінченняСерійний номер діїсертифікату",
                    "value": "2021-06-10T21:00:00Z20B4E4ED0D30998C0400000006FC24004DAD7500"
                },
                "extensionsCertificateInfonotBefore": {
                    "description": "РозширенняПочаток дії",
                    "value": {"2019-06-10T21:00:00Z"
                },
        "personalData": {
       "notAfter": {
                    "description": "ПерсональніЗакінчення данідії",
                    "value": "2021-06-10T21:00:00Z"
       "value": {
         },
                "extensionsCertificateInfo": {
                    "customIddescription": {"Розширення",
                    "value": {
               "description": "Зовнішній ідентифікатор",
       "personalData": {
                            "valuedescription": null "Персональні дані",
                                },"value": {
                                "passportcustomId": {
                                    "description": "ПаспортніЗовнішній даніідентифікатор",
                                    "value": null
                                },
                                "drfoupassport": {
                                    "description": "Реєстраційний номер облікової картки платника податківПаспортні дані",
                                    "value": "2031914098"null
                                },
                                "edrpoudrfou": {
                                    "description": "Код ЕДПРОУРеєстраційний номер облікової картки платника податків",
                                    "value": null"2031914098"
                                },

                                "edrpou": {
                                    "eddrundescription": { "Код ЕДПРОУ",
                                    "descriptionvalue": "Унікальний номер запису в ЄДДР",null
                                },
    "value": null
                           "eddrun": {
    }
                            }
    "description": "Унікальний номер запису в ЄДДР",
               },
                        "alternativeOwnerNamevalue": {null
                            "description": "Альтернативне ім'я власника",    }
                            "value": null}
                        },
                        "subjectKeyIdalternativeOwnerName": {
                            "description": "Ідентифікатор ключаАльтернативне ім'я власника",
                            "value": "9Enull
 03 BA B2 24 4C 3D 02 09 41 08 8E 7E A3 E8 81 CD C6 90 58 B5 9B 38 1F 90 98 DC},
 5D F3 EF 61 8E"
                   "subjectKeyId": {
    },
                        "issuerKeyIddescription": {"Ідентифікатор ключа",
                            "descriptionvalue": "Ідентифікатор9E ключа видавця",
                            "value": "20 B4 E4 ED 0D 30 99 8C BE 30 6A 07 7D 69 9A 32 73 23 8A E9 09 08 71 D6 16 37 0E 18 E5 76 D4 7F"
03 BA B2 24 4C 3D 02 09 41 08 8E 7E A3 E8 81 CD C6 90 58 B5 9B 38 1F 90 98 DC 5D F3 EF 61 8E"
                        },
                        "issuerKeyId": {
    },
                        "subjectOwnerIddescription": {"Ідентифікатор ключа видавця",
                            "descriptionvalue": "Ідентифікатор власника",
                            "value": "0020 B4 E4 ED 0D 30 99 8C BE 30 6A 07 7D 69 9A 32 73 23 8A E9 09 08 71 D6 16 37 0E 18 E5 76 D4 7F"
                        },
                        "certificateProfilesubjectOwnerId": {
                            "description": "ПрофільІдентифікатор сертифікатавласника",
                            "value": null"00"
                        },
                        "keyUsagecertificateProfile": {
                            "description": "ПризначеняПрофіль сертифіката",
                            "value": "Електронний підпис, Невідрікаємість"null
                        },
                        "isTemporarykeyUsage": {
                            "description": "СтартовийПризначення сертифіката",
                            "value": "falseЕлектронний підпис, Невідрікаємість"
                        },
                        "isReinforcedisTemporary": {
                            "description": "ПосиленийСтартовий",
                            "value": "truefalse"
                        },
                        "isQualifiedisReinforced": {
                            "description": "КваліфікованийПосилений",
                            "value": "true"
                        },
                        "isPrivateKeyOnQSCDisQualified": {
                            "description": "Засіб КЕПКваліфікований",
                            "value": "falsetrue"
                        },
                        "qscdTypeNameisPrivateKeyOnQSCD": {
                            "description": "Тип засобуЗасіб КЕП",
                            "value": null
						},
						"isElectronicStamp" : {"false"
                            "description": "Електронна печатка"},
                            "valueqscdTypeName": "false"{
                        }
                    }
           "description": "Тип засобу КЕП",
     }
            }
        }
   "value": ]
}
Пример кода на JavaScript + jQuery 2.2.4
Code Block
languagejs
$.ajax({
    url: "https://localhost:9094/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/ds/verifier",
    type: "GET",
    dataType: "json",
    cache: false
}).done(function (jsonResponse, textStatus, xhr) {
    message = jsonResponse.message;
    verifyResults = jsonResponse.verifyResults;
}).fail(function (xhr) {
    try {
null
						},
						"isElectronicStamp" : {
                            "description": "Електронна печатка",
                            "value": "false"
                     var jsonResponse = JSON.parse(xhr.responseText); }
        message = jsonResponse.message;
        failureCause = jsonResponse.failureCause; }
        verifyResults = jsonResponse.verifyResults;
    } catch (e) {}
        message = (xhr.responseText == undefined)}
 ? "Ошибка при получении результата проверки ЭП." : xhr.responseText; }
    }]
})