Versions Compared

Key

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

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

URL-

...

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

https://local.cipher.kiev.ua:9091/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Время создания ЭПЧас створення ЕП
isValidBooleanДля проверки подписи использовалось время создания подписи, которое заверено электронной меткой времени, или, в случае отсутствия электронной метки времени ЭП, текущее время операционного окруженияперевірки підпису використовувався час створення підпису, яке завірено електронною позначкою часу (ЕПЧ), чи у випадку відсутності ЕПЧ ЕП поточний час операційного оточення.
true
- ЭП действительнаЕП дійсна
false - ЭП недействительнаЕП недійсна
contentTimestampObjectРезультат проверки электронной метки (ЭМВ) времени данных, для которых была создана ЭПперевірки ЕПЧ даних, для яких було створено ЕП
signatureTimestampsArrayРезультаты проверки электронных меток времени электронной подписиРезультат перевірки ЕПЧ ЕП, для яких було створено ЕП
isUntrustedValidBoolean

Для проверки подписи использовалось время создания подписи, которое не заверено электронной меткой времениперевірки підпису використовується час створення ЕП, яке не завірено ЕПЧ
true - ЭП действительнаЕП дійсна
false - ЭП недействительнаЕП недійсна

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

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

Поля объекта об'єкта

Anchor
signerInfo
signerInfo
signerInfo

ПолеТип данныхданихОписаниеОпис
ownerCertificateInfoПолучение результата проверки ЭПObject*Інформація про власника
issuerCertificateInfoИнформация о владельцеПолучение результата проверки ЭПObject*Інформація про видавця
publicKeyCertificateInfoИнформация об издателеПолучение результата проверки ЭПObject*Информация об открытом ключеІнформація про відкритий ключ
certificateSerialNumberObject*Серийный Серійний номер сертификатасертифікату
notBeforeObject*Начало действияПочаток дії
notAfterObject*Окончание действияЗавершення дії
extensionsCertificateInfoПолучение результата проверки ЭПObject*РасширенияРозширення

Поля объекта об'єкта

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

ПолеТип данныхданхОписаниеОпис
personalDataПолучение результата проверки ЭПObject*Персональные данныеПерсональні дані
alternativeOwnerNameObject*Альтернативное имя владельцаАльтернативне ім'я власника
subjectKeyIdObject*Идентификатор Ідентифікатор ключа
issuerKeyIdObject*Идентификатор Ідентифікатор ключа издателявласника
subjectOwnerIdObject*Идентификатор владельцаІдентифікатор власника
certificateProfileObject*Профиль сертификатаПрофіль сертифікату
keyUsageObject*Назначение сертификатаПризначення сертифікату
isTemporaryObject*Признак Ознака стартового сертификатасертифікату
isReinforcedObject*Признак усиленного сертификатаОзнака посиленого сертифікату

Поля объектаоб'єкта 

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

Приклад об'єкта 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
languagejs
$.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; }
    }]
})