Versions Compared

Key

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

Запрос служит для получения данных сертификата в случае, если Сервис был запущен с личными ключами пользователя.  Если Сервис был запущен без ключей, будет возвращен пустой JSON объектЗапит служить для отримання даних сертифікату у випадку, якщо сервіс був запущений з особистим ключами користувача. Якщо Сервіс був запущений без ключів, буде повернуто порожній JSON об'єкт

URL-

...

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

https://local.cipher.kiev.ua:9091/api/v1/certificateInfo/{keyType}

Метод

GET

...

Параметри запиту
keyTypeStringТип ключа
Допустимые значения
Допустимі значення:
signature -
электронная подпись
електронний підпис
keyAgreement -
согласование
узгодження секретного ключа для
шифрования данных
шифрування даних

...

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

...

запиту

ОтсутствуетВідсутні

...

Відповідь
Код
ответа
відповідіContent-type
Допустимые параметрыПример содержимого
Допустимі параметриПриклад вмісту
200application/jsonownerCertificateInfo
issuerCertificateInfo

publicKeyCertificateInfo
certificateSerialNumber
notBefore
notAfter
extensionsCertificateInfo
 

503application/jsonmessage
{
   
    "message" : "
Сервис
Сервіс 
хранения
зберігання 
данных
даних не 
запущен
запущено." 
}
500application/jsonmessage
failureCause

{
   
    "message" : "
Ошибка
Помилка при 
получение
отриманні 
информации
інформації 
о
про 
сертификате
сертифікат.",
"failureCause" : ""
}

...

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

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

Anchor
ownerCertificateInfo
ownerCertificateInfo
 ownerCertificateInfo.value

ПолеТип
данных
даних
Описание
Опис
ownerSurnameObject*
Фамилия
Прізвище
ownerGivennameObject*
Имя отчество
Ім'я, по батькові
ownerFullNameObject*
Полное имя
Повне ім'я
ownerCountryObject*
Страна
Країна
ownerRegionObject*Область
ownerCityObject*
Город
Населений пункт
ownerAddressObject*
Почтовый адрес
Поштова адерса
ownerSerialNumberObject*
Серийный
Серійний номер
владельца
власника
ownerPositionObject*
Должность
Посада

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

Anchor
issuerCertificateInfo
issuerCertificateInfo
 issuerCertificateInfo.value

ПолеТип
данных
даних
Описание
Опис
issuerOrganizationObject*
Организация
Організація
issuerDepartmentObject*
Подразделение
Підрозділ
issuerFullNameObject*
Полное имя
Повне ім'я
issuerCountryObject*
Страна
Країна
issuerRegionObject*Область
issuerCityObject*
Город
Населений пункт
issuerAddressObject*
Почтовый адрес
Поштова адреса
issuerSerialNumberObject*
Серийный
Серійний номер
издателя
видавця

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

Anchor
publicKeyCertificateInfo
publicKeyCertificateInfo
 publicKeyCertificateInfo.value

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

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

Anchor
extensionsCertificateInfo
extensionsCertificateInfo
 extensionsCertificateInfo.value

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

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

Anchor
personalData
personalData
 Получение данных сертификатаextensionsCertificateInfo.value.personalData.value   

ПолеТип
данных
даних
Описание
Опис
customIdObject*
Внешний идентификатор
Зовнішній ідентифікатор
passportObject*
Паспортные данные
Паспортні дані
drfouObject*
Регистрационный номер учетной карточки плательщика налогов
Реєстраційний номер облікової картки платників податків

edrpou

Object*Код
ЕДПРОУ
ЄДРПОУ

eddrun

Object*
Уникальный

Унікальний номер

записи

запису в

ЕГДР

ЄДДР

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

Anchor
CertObject
CertObject
Object* 

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

Пример данных сертификатаПриклад даних сертифікату

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
languagejs
$.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;
    }
})