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
Поля объекта 
Anchor
signerInfo
signerInfo
signerInfo

ПолеТип
данных
даних
ОписаниеПолучение результата проверки ЭП
Опис
ownerCertificateInfoObject*
Информация о владельце
Інформація про власника
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

ПолеТип
данных
данх
ОписаниеПолучение результата проверки ЭП
Опис
personalDataObject*
Персональные данные
Персональні дані
alternativeOwnerNameObject*
Альтернативное имя владельца
Альтернативне ім'я власника
subjectKeyIdObject*Ідентифікатор ключа
issuerKeyId
subjectKeyId
Object*
Идентификатор
Ідентифікатор ключа власника
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

Code Block
{
    "message": "ЭлектроннаяЕлектронний подписьпідпис действительнадійсний.",
    "verifyResults": [
        {
            "status": "SUCCESS",
    "signerInfo": {
        "ownerCertificateInfofailureCause": {"",
            "descriptionisValid": "Владелец"true,
            "valuesigningDateTime": {"2020-03-05T13:25:36Z",
            "contentTimestamp": {},
    "ownerSurname": {"description": "Фамилия", "value": "Горобець"},        "signatureTimestamps": [
                "ownerGivenname": {"description": "Имя отчество", "value": "Сергій Миколайович"},

                    "ownerFullNameisValid": {"description": "Полное имя", "value": "Горобець Сергій Миколайович"}true,
                    "isFailure": false,
                "ownerCountry": {"description": "Страна", "value    "dateTime": "UA"}2020-03-05T13:25:39Z",
                 "ownerRegion": {"description": "Область", "valuetsaCertificateSerialNumber": "Київська3DB73E7BF0D575B20200000001000000BB000000"},
                "ownerCity": {"description": "Город", "value": "Київ"},
}
            ],
        "ownerAddress": {"description": "Почтовый адрес", "valuesignerInfo": null},{
                "ownerSerialNumberownerCertificateInfo": {"description": "Серийный номер владельца", "value": "00"},

                    "ownerPositiondescription": {"description": "Должность", "value": "Фізична особа"}
Власник",
                    "value": }{
        },
                "issuerCertificateInfoownerSurname": {
                            "description": "ИздательПрізвище",
            "value": {
                "issuerOrganizationvalue": {"descriptionБоровіков": "Организация", "value": "\"АТ \\\"ІІТ\\\"\""},

                      "issuerDepartment": {"description": "Подразделение", "value": "Тестовий ЦСК"},
 },
                    "issuerFullName": {"description": "Полное имя", "valueownerGivenname": "\"Тестовий ЦСК АТ \\\"ІІТ\\\"\""},
{
                           "issuerCountry": {"description": "СтранаІмя по-батькові", "value": "UA"},

                         "issuerRegion": {"description": "Область", "value": "ХарківськаОлександр Михайлович"},
                "issuerCity": {"description": "Город", "value": "Харків"},
        },
                        "issuerAddressownerFullName": {"description": "Почтовый адрес", "value": null},

                       "issuerSerialNumber": {"description": "Серийный номер издателя", "valuedescription": "00"}Повне ім'я",
            }
         },
        "publicKeyCertificateInfovalue": {"Боровіков Олександр Михайлович"
            "description": "Информация об открытом ключе",
            },
       "value": {
                "publicKeyownerCountry": {
                            "description": "Открытый ключКраїна",
                            "value": "UA"FF
 EF A8 08 00 31 E3 2A D7 D6 BB EF 9E D4 49 79 9D 88 F7 BB 22 23 8F 0C 8D 5E 9D A9 4A FA 24 9B 00"
},
                       }, "dsAlgorismownerRegion": {"description": "Алгоритм ЭП", "value": "ДСТУ 4145-2002, ПБ, little-endian"}

                     }
        }"description": "Область",
        "certificateSerialNumber": {
            "description       "value": "Серийный номер сертификата",null
            "value": "5B 63 D8 83 75 D9 20 18 04 00 00 00},
 25 07 00 00 77 10 00 00"
        },
        "notBeforeownerCity": {"description": "Начало действия", "value": "Fri Feb 05 00:00:00 EET 2016"},

                           "notAfter": {"description": "Окончание действияМісто",
 "value": "Mon Feb 05 00:00:00 EET 2018"},
        "extensionsCertificateInfo": {
            "descriptionvalue": "РасширенияКиїв",
            "value": {
            },
    "personalData": {
                    "descriptionownerAddress": "Персональные данные",
{
                            "valuedescription": { "Поштова адреса",
                        "customId": {"description": "Внешний идентификатор", "value": null},
                        "passport": {"description": "Паспортные данные", "value": null},
                        "drfouownerSerialNumber": {
                            "description": "РегистрационныйСерійний номер учетной карточки плательщика налоговвласника",
                            "value": null"2423814"
                        },
                        "edrpouownerPosition": {"description": "Код ЕДПРОУ", "value": null},

                            "eddrundescription": {"description": "Уникального номера записи в ЕГДР", "value": null}
Посада",
                            "value": }
null
                        },
                 "alternativeOwnerName       "ownerOrganization": {
                    "description": "Альтернативное имя владельца",
        "description": "Організація",
                            "value": "sergey.gorobets@unity-bars.com"
null
                        },
                  "subjectKeyId      "ownerOrganizationUnit": {
                            "description": "ИдентификаторВідділ ключа(підрозділ)",
                    "value": "EF E5 01 81 59 F6 F3 D2 FE E9 7B A7 42 77 69 93 87 20 D6 31 99 C8 59 D9 7C 28 7B D1 B5 D0 F4 0B"
   "value": null
                        }
               },
     }
           "subjectOwnerId": {"description": "Идентификатор владельца", "value": "00"},
                "certificateProfileissuerCertificateInfo": {"description": "Профиль сертификата", "value": null},

                    "keyUsage": {"description": "Назначение сертификатаВидавник",
 "value": "Электронная подпись, Неотрекаемость"},
                "isTemporaryvalue": {"description": "Стартовый", "value": "false"},

                     "isReinforced": {"description": "Усиленный", "valueissuerOrganization": "true"}{
            }
        }
    },
    "signingDateTimedescription": "Wed Dec 21 12:28:24 EET 2016",
Організація",
                      "isValid": true
}]
Пример кода на 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: "GET",
    dataType: "json",
    cache: false
}).done(function (jsonResponse, textStatus, xhr) {
    message = jsonResponse.message;
    verifyResults = jsonResponse.verifyResults;
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);value": "Інформаційно-довідковий департамент ДФС"
                        },
                        "issuerDepartment": {
                            "description": "Підрозділ",
                            "value": "Управління (центр) сертифікації ключів ІДД ДФС"
                        },
                        "issuerFullName": {
                            "description": "Повне ім'я",
                            "value": "Акредитований центр сертифікації ключів ІДД ДФС"
                        },
                        "issuerCountry": {
                            "description": "Країна",
                            "value": "UA"
                        },
                        "issuerRegion": {
                            "description": "Область",
                            "value": null
                        },
                        "issuerCity": {
                            "description": "Місто",
                            "value": "Київ"
                        },
                        "issuerAddress": {
                            "description": "Поштова адреса",
                            "value": null
                        },
                        "issuerSerialNumber": {
                            "description": "Серійний номер видавця",
                            "value": "UA-39384476-2018"
                        }
                    }
                },
                "publicKeyCertificateInfo": {
                    "description": "Інформація про відкритий ключ",
                    "value": {
                        "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"
                        },
                        "dsAlgorism": {
                            "description": "Алгоритм ЕП",
                            "value": "ДСТУ 4145-2002, ПБ, little-endian"
                        }
                    }
                },
                "certificateSerialNumber": {
                    "description": "Серійний номер сертифікату",
                    "value": "20B4E4ED0D30998C0400000006FC24004DAD7500"
                },
                "notBefore": {
                    "description": "Початок дії",
                    "value": "2019-06-10T21:00:00Z"
                },
                "notAfter": {
                    "description": "Закінчення дії",
                    "value": "2021-06-10T21:00:00Z"
                },
                "extensionsCertificateInfo": {
                    "description": "Розширення",
                    "value": {
                        "personalData": {
                            "description": "Персональні дані",
                            "value": {
                                "customId": {
                                    "description": "Зовнішній ідентифікатор",
                                    "value": null
                                },
                                "passport": {
                                    "description": "Паспортні дані",
                                    "value": null
                                },
                                "drfou": {
                                    "description": "Реєстраційний номер облікової картки платника податків",
                                    "value": "2031914098"
                                },
                                "edrpou": {
                                    "description": "Код ЕДПРОУ",
                                    "value": null
                                },
                                "eddrun": {
                                    "description": "Унікальний номер запису в ЄДДР",
                                    "value": null
                                }
                            }
                        },
                        "alternativeOwnerName": {
                            "description": "Альтернативне ім'я власника",
                            "value": null
                        },
                        "subjectKeyId": {
                            "description": "Ідентифікатор ключа",
                            "value": "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": {
                            "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"
                        },
                        "subjectOwnerId": {
                            "description": "Ідентифікатор власника",
                            "value": "00"
                        },
                        "certificateProfile": {
                            "description": "Профіль сертифіката",
                            "value": null
                        },
                        "keyUsage": {
                            "description": "Призначеня сертифіката",
                            "value": "Електронний підпис, Невідрікаємість"
                        },
                        "isTemporary": {
                            "description": "Стартовий",
                            "value": "false"
                        },
                        "isReinforced": {
                            "description": "Посилений",
                            "value": "true"
                        }
        message = jsonResponse.message;
        failureCause = jsonResponse.failureCause; }
        verifyResults = jsonResponse.verifyResults;
    } catch (e) {}
        message = (xhr.responseText == undefined) ? "Ошибка при получении результата проверки ЭП." : xhr.responseText; }
        }
    }]
})