Запрос служит для получения данных сертификата в случае, если Сервис был запущен с личными ключами пользователя. Если Сервис был запущен без ключей, будет возвращен пустой JSON объектЗапит служить для отримання даних сертифікату у випадку, якщо сервіс був запущений з особистим ключами користувача. Якщо Сервіс був запущений без ключів, буде повернуто порожній JSON об'єкт.
URL-
...
адреса запиту
https://local.cipher.kiev.ua:9091/api/v1/certificateInfo/{keyType}
Метод
GET
...
Параметри запиту
keyType | String | Тип ключа |
Допустимі значення: signature - |
електронний підпис keyAgreement - |
узгодження секретного ключа для |
шифрування даних |
...
Налаштовувані заголовки
...
запиту
ОтсутствуетВідсутні
...
Відповідь
Код |
---|
відповіді | Content-type |
---|
Допустимі параметри | Приклад вмісту | |
---|---|---|
200 | application/json | ownerCertificateInfo issuerCertificateInfo publicKeyCertificateInfo certificateSerialNumber notBefore notAfter extensionsCertificateInfo |
503 | application/json | message | { |
"message" : " |
Сервіс |
зберігання |
даних не |
запущено." } | |||
500 | application/json | message failureCause | { |
"message" : " |
Помилка при |
отриманні |
інформації |
про |
сертифікат.", |
...
Параметри JSON об'єкта відповіді
Параметр | Тип |
---|
даних |
---|
Опис | |
---|---|
message | String |
Опис результату проведення операції | |
failureCause | String |
Опис причини виникнення помилки, яка виникла при виконанні запиту на перевірку ЕП | |
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* |
Посада |
Поля объектаоб'єкта
issuerCertificateInfo.value Anchor issuerCertificateInfo issuerCertificateInfo
Поле | Тип |
---|
даних |
---|
Опис | |
---|---|
issuerOrganization | Object* |
Організація | |
issuerDepartment | Object* |
Підрозділ | |
issuerFullName | Object* |
Повне ім'я | |
issuerCountry | Object* |
Країна | ||
issuerRegion | Object* | Область |
issuerCity | Object* |
Населений пункт | |
issuerAddress | Object* |
Поштова адреса | |
issuerSerialNumber | Object* |
Серійний номер |
видавця |
Поля объектаоб'єкта
publicKeyCertificateInfo.value Anchor publicKeyCertificateInfo publicKeyCertificateInfo
Поле | Тип |
---|
даних |
---|
Опис | |
---|---|
publicKey | Object* |
Відкритий ключ | ||
dsAlgorism | Object* | Алгоритм |
ЕП |
Поля объектаоб'єкта
extensionsCertificateInfo.value Anchor extensionsCertificateInfo extensionsCertificateInfo
Поле | Тип |
---|
даних |
---|
Опис |
---|
personalData | Object* |
Персональні дані | |
alternativeOwnerName | Object* |
Алетернативне ім'я власника | |
subjectKeyId | Object* |
Ідентифікатор ключа | |
subjectOwnerId | Object* |
Ідентифікатор власника | |
certificateProfile | Object* |
Прифіль сертифікату | |
keyUsage | Object* |
Призначення сертфиікату | |
isTemporary | Object* |
Ознака стартового |
сертифікату | |
isReinforced | Object* |
Ознака посиленого сертифікату |
Поля объектаоб'єкта
Получение данных сертификата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Приклад даних сертифікату
Code Block |
---|
{
"ownerCertificateInfo": {
"description": "Власник",
"value": {
"ownerSurname": {"description": "Прізвище", "value": "Тестовый"},
"ownerGivenname": {"description": "Імя по-батькові", "value": "Сертификат6 Стартовый"},
"ownerFullName": {"description": "Повне ім'я", "value": "Тестовый Сертификат 6"},
"ownerCountry": {"description": "Країна", "value": "ua"},
"ownerRegion": {"description": "Область", "value": "Харьковская"},
"ownerCity": {"description": "Місто", "value": "Харьков"},
"ownerAddress": {"description": "Поштова адреса", "value": "\"пр. Науки"},
"ownerSerialNumber": {"description": "Серійний номер власника", "value": "46 30 07 62 53 88 0D 40"},
"ownerPosition": {"description": "Посада", "value": "Разработчик"}
}
},
"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": "46 30 07 62 53 88 0D 40"}
}
},
"publicKeyCertificateInfo": {
"description": "Інформація про відкритий ключ",
"value": {
"publicKey": {
"description": "Відкритий ключ",
"value": "8D 39 4C DA 49 7D 1D A7 46 92 FE 97 A4 1D 0B AD C3 B0 9F 1B 5C 07 8C 79 31 72 36 92 40 08 2E 13 00"
}, "dsAlgorism": {"description": "Алгоритм ЕП", "value": "ДСТУ 4145-2002, ПБ, little-endian"}
}
}, "certificateSerialNumber": {"description": "Серійний номер сертифікату", "value": "E5 69 8B B0 4D A1 BF 2F"},
"notBefore": {"description": "Початок дії", "value": "Sat Nov 19 00:00:00 EET 2016"},
"notAfter": {"description": "Закінчення дії", "value": "Sun Nov 19 00:00:00 EET 2017"},
"extensionsCertificateInfo": {
"description": "Розширення",
"value": {
"personalData": {
"description": "Персональні дані",
"value": {
"customId": {"description": "Зовнішній ідентифікатор", "value": "000006"},
"passport": {"description": "Паспортні дані", "value": "КН000006"},
"drfou": {"description": "Реєстраційний номер облікової картки платника податків", "value": null},
"edrpou": {"description": "Код ЕДПРОУ", "value": null},
"eddrun": {"description": "Унікальний номер запису в ЄДДР", "value": null}
}
},
"alternativeOwnerName": {"description": "Альтернативне ім'я власника", "value": "test@cipher.com"},
"subjectKeyId": {
"description": "Ідентифікатор ключа",
"value": "B6 2F CE 32 A7 23 48 AB FB 26 F1 5A 4C 04 F9 1A 5E CF 03 D4 98 3E 86 AC 07 32 75 8D 59 37 4C A0"
},
"subjectOwnerId": {"description": "Ідентифікатор власника", "value": "46 30 07 62 53 88 0D 40"},
"certificateProfile": {"description": "Профіль сертифіката", "value": "3"},
"keyUsage": {"description": "Призначеня сертифіката", "value": "Електронний підпис, Невідрікаємість"},
"isTemporary": {"description": "Стартовий", "value": "false"},
"isReinforced": {"description": "Посилений", "value": "false"}
}
}
} |
Пример кода на JavaScript + jQuery 2.2.4
Code Block | ||
---|---|---|
| ||
$.ajax({ url: "https://local.cipher.kiev.ua:9091/api/v1/certificateInfo/signature", type: "GET", dataType: "json", cache: false }).done(function (jsonResponse, textStatus, xhr) { certInfo = jsonResponse; }).fail(function (xhr) { try { var jsonResponse = JSON.parse(xhr.responseText); message = jsonResponse.message; failureCause = jsonResponse.failureCause; } catch (e) { message = (xhr.responseText == undefined) ? "Ошибка при получении данных сертификата." : xhr.responseText; } }) |