Page History

Запрос служит для получения результата проверки ЭП. Запрос является блокирующим, то есть результат будет получен только после завершения процесса проверки ЭП, если такой был ранее запущен. Если ЭП действительна, будет возвращен Запит служить для отримання результату перевірки ЕП. Запит є блокуючим, тобто результат буде отримано лише після завершення процесу перевірки ЕП, якщо такий був раніше запущений. Якщо ЕП дійсний, то буде повернуто 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	{ "message" : "ЭлектроннаяЕлектронний подписьпідпис действительнадійсний.", "verifyResults" : Array }
503	application/json	message	{ "message" : "СервисСервіс выполнениявиконання криптографическихкриптографічних операцийоперацій не запущензапущено." }
400	application/json	message	{ "message" : "СессияСесія отсутствуетвідсутня." }
406	application/json	message verifyResults failureCause	{ "message" : "ЭлектроннаяЕлектронний подписьпідпис не действительнадійсний.", "failureCause" : "", "verifyResults" : Array }

...

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

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

Поле	Тип данныхданих	ОписаниеОпис
isValid	Boolean	true - ЭМВ действительнаЕПЧ дійсна false - ЭМВ недействительнаЕПЧ недійсна
isFailure	Boolean	true - при проверке ЭМВ возникла ошибкаперевірці ЕПЧ виникла помилка false - при проверке ЭМВ ошибок не возникалоперевірці ЕПЧ помилок не виникало
dateTime	DateTime	Значение даты и времени в формате Значення дати та часу в форматі ISO 8601, которое заверено ЭМВяке завірено ЕПЧ
tsaCertificateSerialNumber	Object*	Серийный Серійний номер сертификата сертифікату TSP-сервера

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

Anchor

	signerInfo
	signerInfo

signerInfo

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

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

Anchor

	ownerCertificateInfo
	ownerCertificateInfo

Получение результата проверки ЭП signerInfo.ownerCertificateInfo.value

Поле	Тип данныхданих	ОписаниеОпис
ownerSurname	Object*	ФамилияПрізвище
ownerGivenname	Object*	Имя отчествоІм'я, по батькові
ownerFullName	Object*	Полное имяПовне ім'я
ownerCountry	Object*	СтранаКраїна
ownerRegion	Object*	Область
ownerCity	Object*	ГородНаселений пункт
ownerAddress	Object*	Почтовый адресПоштова адреса
ownerSerialNumber	Object*	Серийный Серійний номер владельцавласника
ownerPosition	Object*	ДолжностьПосада

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

Anchor

	issuerCertificateInfo
	issuerCertificateInfo

Получение результата проверки ЭП signerInfo.issuerCertificateInfo.value

Поле	Тип данныхданих	ОписаниеОпис
issuerOrganization	Object*	ОрганизацияОрганізація
issuerDepartment	Object*	ПодразделениеПідрозділ
issuerFullName	Object*	Полное имяПовне ім'я
issuerCountry	Object*	СтранаКраїна
issuerRegion	Object*	Область
issuerCity	Object*	ГородНаселений пункт
issuerAddress	Object*	Почтовый адресПоштова адреса
issuerSerialNumber	Object*	Серийный Серійний номер издателявидавця

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

Anchor

	publicKeyCertificateInfo
	publicKeyCertificateInfo

Получение результата проверки ЭП signerInfo.publicKeyCertificateInfo.value

Поле	Тип данныхданих	ОписаниеОпис
publicKey	Object*	Открытый Відкритий ключ
dsAlgorism	Object*	Алгоритм ЭПЕП

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

Anchor

	extensionsCertificateInfo
	extensionsCertificateInfo

Получение результата проверки ЭП signerInfo.extensionsCertificateInfo.value

Поле	Тип данныхданх	Описание
personalData Получение результата проверки ЭП	Object*	Персональные данныеПерсональні дані
alternativeOwnerName	Object*	Альтернативное имя владельцаАльтернативне ім'я власника
subjectKeyId	Object*	Идентификатор Ідентифікатор ключа
issuerKeyId	Object*	Идентификатор Ідентифікатор ключа издателявласника
subjectOwnerId	Object*	Идентификатор владельцаІдентифікатор власника
certificateProfile	Object*	Профиль сертификатаПрофіль сертифікату
keyUsage	Object*	Назначение сертификатаПризначення сертифікату
isTemporary	Object*	Признак Ознака стартового сертификатасертифікату
isReinforced	Object*	Признак усиленного сертификатаОзнака посиленого сертифікату

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

Anchor

	personalData
	personalData

Получение результата проверки ЭП.Получение результата проверки ЭПsignerInfo.extensionsCertificateInfo.value.personalData.value

Поле	Тип данныхданих	ОписаниеОпис
customId	Object*	Внешний идентификаторЗовнішній ідентифікатор
passport	Object*	Паспортные данныеПаспортні дані
drfou	Object*	Регистрационный номер учетной карточки плательщика налоговРеєстраційний номер облікової картки платників податків
edrpou	Object*	Код ЕГРПОУЄДРПОУ
eddrun	Object*	Уникальный Унікальний номер записи запису в ЕГДРЕДДР

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

Anchor

	CertObject
	CertObject

Object*

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

Пример объекта Приклад об'єкта signerInfo

Code Block

{
    "message": "Електронний підпис дійсний.",
    "verifyResults": [
        {
            "status": "SUCCESS",
            "failureCause": "",
            "isValid": true,
            "signingDateTime": "2020-03-05T13:25:36Z",
            "contentTimestamp": {},
            "signatureTimestamps": [
                {
                    "isValid": true,
                    "isFailure": false,
                    "dateTime": "2020-03-05T13:25:39Z",
                    "tsaCertificateSerialNumber": "3DB73E7BF0D575B20200000001000000BB000000"
                }
            ],
            "signerInfo": {
                "ownerCertificateInfo": {
                    "description": "Власник",
                    "value": {
                        "ownerSurname": {
                            "description": "Прізвище",
                            "value": "Боровіков"
                        },
                        "ownerGivenname": {
                            "description": "Імя по-батькові",
                            "value": "Олександр Михайлович"
                        },
                        "ownerFullName": {
                            "description": "Повне ім'я",
                            "value": "Боровіков Олександр Михайлович"
                        },
                        "ownerCountry": {
                            "description": "Країна",
                            "value": "UA"
                        },
                        "ownerRegion": {
                            "description": "Область",
                            "value": null
                        },
                        "ownerCity": {
                            "description": "Місто",
                            "value": "Київ"
                        },
                        "ownerAddress": {
                            "description": "Поштова адреса",
                            "value": null
                        },
                        "ownerSerialNumber": {
                            "description": "Серійний номер власника",
                            "value": "2423814"
                        },
                        "ownerPosition": {
                            "description": "Посада",
                            "value": null
                        },
                        "ownerOrganization": {
                            "description": "Організація",
                            "value": null
                        },
                        "ownerOrganizationUnit": {
                            "description": "Відділ (підрозділ)",
                            "value": null
                        }
                    }
                },
                "issuerCertificateInfo": {
                    "description": "Видавник",
                    "value": {
                        "issuerOrganization": {
                            "description": "Організація",
                            "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"
                        }
                    }
                }
            }
        }
    ]
}

...

Приклад коду на JavaScript + jQuery 2.2.4

Code Block

language	js

$.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);
        message = jsonResponse.message;
        failureCause = jsonResponse.failureCause; 
        verifyResults = jsonResponse.verifyResults;
    } catch (e) {
        message = (xhr.responseText == undefined) ? "ОшибкаПомилка при полученииотриманні результатарезультату проверкиперевірки ЭПЕП." : xhr.responseText;
    }
})

Page tree

Versions Compared

Old Version 19

New Version 20

Key

URL-

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

Метод

Параметри запиту

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

запиту

Відповідь

Параметри JSON об'єкта відповіді

Приклад коду на JavaScript + jQuery 2.2.4