Запрос служит для получения результата проверки ЭП. Запрос является блокирующим, то есть результат будет получен только после завершения процесса проверки ЭП, если такой был ранее запущен. Если ЭП действительна, будет возвращен Запит служить для отримання результату перевірки ЕП. Запит є блокуючим, тобто результат буде отримано лише після завершення процесу перевірки ЕП, якщо такий був раніше запущений. Якщо ЕП дійсний, то буде повернуто HTTP статус код 200. Если в ЭП не действительна или в процессе ее непосредственной проверки возникли ошибки, будет возвращен HTTP Якщо ЕП недійсний чи в процессі безпосередньої перевірки виникли помилки, буде повернуто HTTP статус код 406. При возникновении других типов ошибок, возвращаются HTTP статус коды 503 или виникненні інших типів помилок, повертається HTTP статус код 503 чи 400.
URL-
...
адреса запиту
https://local.cipher.kiev.ua:9091/api/v1/ticket/{uuid}/ds/verifier
Метод
GET
...
Параметри запиту
uuid | StringИдентификатор | сессииІдентифікатор сесії |
...
Налаштовувані заголовки
...
запиту
ОтсутствуетВідсутні
...
Відповідь
Код ответавідповіді | Content-type | Допустимые параметры | Допустимі параметри | Приклад вмістуПример содержимого |
---|---|---|---|---|
200 | application/json | message verifyResults | { | |
503 | application/json | message | { "message" : "СервисСервіс выполнениявиконання криптографическихкриптографічних операцийоперацій не запущензапущено." } | |
400 | application/json | message | { "message" : "СессияСесія отсутствуетвідсутня." } | |
406 | application/json | message verifyResults failureCause | { |
...
Параметри JSON об'єкта відповіді
Параметр | Тип данныхданих | ОписаниеОпис | |
---|---|---|---|
message | String | Описание результата проведения операцииОпис результату проведення операції | |
failureCause | String | Описание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭПОпис причини виникнення помилки, яка виникає при виконанні запиту на перевірку ЕП | |
verifyResults | Array | Результаты проверки отдельно по каждой из ЭП | Результати перевірки окремо по кожного ЕП |
Поля елемента масиву Поля элемента массива verifyResults
Поле | Тип | данныхданих | ОписаниеОпис |
---|---|---|---|
status | String | "SUCCESS" - проверка ЭП произведена без ошибокперевірка ЕП виконана без помилок "FAILURE" - в процессе проверки ЭП возникли ошибкипроцесі перевірки ЕП виникли помилки | |
failureCause | String | Описание причины возникновения ошибки, которая возникла при непосредственной проверке ЭПОпис причини виникнення помилки, яка виникла при безпосередній перевірці ЕП | |
signerInfo | Object | Информация из сертификата владельца ЭПІнформація з сертифікату власника ЕП | |
signingDateTime | String | Время создания ЭПЧас створення ЕП | |
isValid | Boolean | Для проверки подписи использовалось время создания подписи, которое заверено электронной меткой времени, или, в случае отсутствия электронной метки времени ЭП, текущее время операционного окруженияперевірки підпису використовувався час створення підпису, яке завірено електронною позначкою часу (ЕПЧ), чи у випадку відсутності ЕПЧ ЕП поточний час операційного оточення. true - ЭП действительнаЕП дійсна false - ЭП недействительнаЕП недійсна | |
contentTimestamp | Object | Результат проверки электронной метки (ЭМВ) времени данных, для которых была создана ЭПперевірки ЕПЧ даних, для яких було створено ЕП | |
signatureTimestamps | Array | Результаты проверки электронных меток времени электронной подписиРезультат перевірки ЕПЧ ЕП, для яких було створено ЕП | |
isUntrustedValid | Boolean | Для проверки подписи использовалось время создания подписи, которое не заверено электронной меткой времениперевірки підпису використовується час створення ЕП, яке не завірено ЕПЧ |
Поля объекта об'єкта contentTimestamp, элемента массива елемента масиву signatureTimestamps
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
isValid | Boolean | true - ЭМВ действительнаЕПЧ дійсна false - ЭМВ недействительнаЕПЧ недійсна |
isFailure | Boolean | true - при проверке ЭМВ возникла ошибкаперевірці ЕПЧ виникла помилка false - при проверке ЭМВ ошибок не возникалоперевірці ЕПЧ помилок не виникало |
dateTime | DateTime | Значение даты и времени в формате Значення дати та часу в форматі ISO 8601, которое заверено ЭМВяке завірено ЕПЧ |
tsaCertificateSerialNumber | Object* | Серийный Серійний номер сертификата сертифікату TSP-сервера |
Поля объекта об'єкта
Anchor | ||||
---|---|---|---|---|
|
Поле | Тип данныхданих | Описание | Опис | |
---|---|---|---|---|
ownerCertificateInfoПолучение результата проверки ЭП | Object* | Інформація про власника | ||
issuerCertificateInfo | Информация о владельце | Получение результата проверки ЭП | Object* | Інформація про видавця |
publicKeyCertificateInfo | Информация об издателе | Получение результата проверки ЭП | Object* | Информация об открытом ключеІнформація про відкритий ключ |
certificateSerialNumber | Object* | Серийный Серійний номер сертификатасертифікату | ||
notBefore | Object* | Начало действияПочаток дії | ||
notAfter | Object* | Окончание действия | Завершення дії | |
extensionsCertificateInfoПолучение результата проверки ЭП | Object* | РасширенияРозширення |
Поля объекта об'єкта
Anchor | ||||
---|---|---|---|---|
|
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
ownerSurname | Object* | ФамилияПрізвище |
ownerGivenname | Object* | Имя отчествоІм'я, по батькові |
ownerFullName | Object* | Полное имяПовне ім'я |
ownerCountry | Object* | СтранаКраїна |
ownerRegion | Object* | Область |
ownerCity | Object* | ГородНаселений пункт |
ownerAddress | Object* | Почтовый адресПоштова адреса |
ownerSerialNumber | Object* | Серийный Серійний номер владельцавласника |
ownerPosition | Object* | ДолжностьПосада |
Поля объектаоб'єкта
Получение результата проверки ЭПsignerInfo.issuerCertificateInfo.value Anchor issuerCertificateInfo issuerCertificateInfo
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
issuerOrganization | Object* | ОрганизацияОрганізація |
issuerDepartment | Object* | ПодразделениеПідрозділ |
issuerFullName | Object* | Полное имяПовне ім'я |
issuerCountry | Object* | СтранаКраїна |
issuerRegion | Object* | Область |
issuerCity | Object* | ГородНаселений пункт |
issuerAddress | Object* | Почтовый адресПоштова адреса |
issuerSerialNumber | Object* | Серийный Серійний номер издателявидавця |
Поля объектаоб'єкта
Получение результата проверки ЭПsignerInfo.publicKeyCertificateInfo.value Anchor publicKeyCertificateInfo publicKeyCertificateInfo
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
publicKey | Object* | Открытый Відкритий ключ |
dsAlgorism | Object* | Алгоритм ЭПЕП |
Поля объектаоб'єкта
Получение результата проверки ЭПsignerInfo.extensionsCertificateInfo.value Anchor extensionsCertificateInfo extensionsCertificateInfo
Поле | Тип данныхданх | Описание | Опис |
---|---|---|---|
personalDataПолучение результата проверки ЭП | Object* | Персональные данныеПерсональні дані | |
alternativeOwnerName | Object* | Альтернативное имя владельцаАльтернативне ім'я власника | |
subjectKeyId | Object* | Идентификатор Ідентифікатор ключа | |
issuerKeyId | Object* | Идентификатор Ідентифікатор ключа издателявласника | |
subjectOwnerId | Object* | Идентификатор владельцаІдентифікатор власника | |
certificateProfile | Object* | Профиль сертификатаПрофіль сертифікату | |
keyUsage | Object* | Назначение сертификатаПризначення сертифікату | |
isTemporary | Object* | Признак Ознака стартового сертификатасертифікату | |
isReinforced | Object* | Признак усиленного сертификатаОзнака посиленого сертифікату |
Поля объектаоб'єкта
Получение результата проверки ЭП.Получение результата проверки ЭПsignerInfo.extensionsCertificateInfo.value.personalData.value Anchor personalData personalData
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
customId | Object* | Внешний идентификаторЗовнішній ідентифікатор |
passport | Object* | Паспортные данныеПаспортні дані |
drfou | Object* | Регистрационный номер учетной карточки плательщика налоговРеєстраційний номер облікової картки платників податків |
edrpou | Object* | Код ЕДПРОУЄДРПОУ |
eddrun | Object* | Уникальный Унікальний номер записи запису в ЕГДРЕДДР |
Поля объекта типа об'єкта типу
Anchor | ||||
---|---|---|---|---|
|
Поле | Тип данныхданих | ОписаниеОпис |
---|---|---|
description | String | Описание Опис поля на языке, который выбран пользователем в Сервисемові, яку обрано користувачем в Сервісі |
value | [Object, String, Boolean, Number, Array, null] | Значение Значення поля |
Пример объекта signerInfo
Приклад об'єкта signerInfo
Code Block |
---|
{
"message": "Електронний підпис дійсний." |
Code Block |
{ "message": "Електронний підпис дійсний.", "verifyResults": [ { "status": "SUCCESS", "failureCause": "", "isValid": true, "signingDateTime": "2020-03-05T13:25:36Z", "contentTimestamp": {}, "signatureTimestamps"verifyResults": [ { "isValid"status": true"SUCCESS", "failureCause": "", "isFailure": 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": { "description": "Прізвище", "ownerCertificateInfo": { "valuedescription": "БоровіковВласник", },"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": { }, "issuerCertificateInfodescription": {"Відділ (підрозділ)", "description "value": "Видавник", null "value": { } } "issuerOrganization": { }, "descriptionissuerCertificateInfo": "Організація", { "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" }, "eddrunedrpou": { "description": "Унікальний номер запису в ЄДДРКод ЕДПРОУ", "value": null }, } "eddrun": { }, "description": "Унікальний номер запису в ЄДДР", "alternativeOwnerName": { "descriptionvalue": "Альтернативне ім'я власника", null "value": null} }, } "subjectKeyId": { }, "descriptionalternativeOwnerName": "Ідентифікатор ключа",{ "valuedescription": "9EАльтернативне 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"ім'я власника", "value": null }, "issuerKeyIdsubjectKeyId": { "description": "Ідентифікатор ключа видавця", "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"9E 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": "00"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" }, "certificateProfilesubjectOwnerId": { "description": "ПрофільІдентифікатор сертифікатавласника", "value": null"00" }, "keyUsagecertificateProfile": { "description": "ПризначеняПрофіль сертифіката", "value": "Електронний підпис, Невідрікаємість"null }, "isTemporarykeyUsage": { "description": "СтартовийПризначеня сертифіката", "value": "falseЕлектронний підпис, Невідрікаємість" }, "isReinforcedisTemporary": { "description": "Посилений", "value": "true" Стартовий", } "value": "false" } }, } } "isReinforced": { } ] } |
Пример кода на JavaScript + jQuery 2.2.4
Code Block | ||
---|---|---|
| ||
$.ajax({ url: "https://local.cipher.kiev.ua:9091/api/v1/ticket/79343564-147f-4a2a-ac2a-182d7a55f802/ds/verifier", type"description": "GETПосилений", dataType: "json", cache: false }).done(function (jsonResponse, textStatus, xhr) { message = jsonResponse.message; verifyResults = jsonResponse.verifyResults; }).fail(function (xhr) { "value": "true" try { var jsonResponse = JSON.parse(xhr.responseText); } message = jsonResponse.message; failureCause = jsonResponse.failureCause; } verifyResults = jsonResponse.verifyResults; } catch (e) {} message = (xhr.responseText == undefined)} ? "Ошибка при получении результата проверки ЭП." : xhr.responseText; } }] }) |