Versions Compared

Key

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

Запит використовується для отримання діючого сертифікату ключа, який знаходиться в ключовому контейнері сесії. Сертифікат повертається у кодуванні ASN.1 у вигляді Base64 рядка. Якщо ключ вказаного типу відсутній, буде повернено порожній JSON обʼєкт.

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

Запрос служит для получения действующего сертификата ключа, который находится в ключевом контейнере сессии. Сертификат возвращается в кодировке ASN.1 в виде Base64 строки. Если ключ указанного типа отсутствует, будет возвращен пустой JSON объект.

...

https://localhost:9094/api/v1/ticket/{uuid}/keyStore/certificate/base64/{keyType}

Метод

PUT

...

Параметри запиту
uuidStringИдентификатор сессииІдентифікатор сесії
keyTypeString

Тип ключа

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

...

шифрування

Налаштовувані заголовки запиту
Content-Typeapplication/json

...

Параметри JSON

...

обʼєкта запиту
Имя

Імʼя

Тип

Описание

Опис

Допустимые значения

Допустимі значення

keyStorePassword

StringПароль
к ключевому
до ключового контейнеру
сессии
сесії
Строка, которая представляет собой пароль для доступа к ключевому контейнеру сессии. Ключевой контейнер сессии должен быть ранее загружен с помощью специального запроса.
Ответ
Рядок, який являє собою пароль для доступу до ключового контейнеру оль для доступа сесії. Ключовий контейнер сесії має бути раніше завантажений за допомогою спеціального запиту.
Відповідь
Код відповідіКод ответаContent-typeДопустимые параметрыДопустимі параметриПриклад вмістуПример содержимого
200application/jsonbase64Data

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

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

...

Параметри JSON

...

обʼєкта відповіді
ПараметрТип данныхданихОписаниеОпис
base64Database64DataBase64 строка с действующим сертификатом в кодировке рядок з діючим сертифікатом у кодуванні ASN.1
messageStringОписание результата проведения операцииОпис результату проведення операції
failureCause StringОписание причины возникновения ошибки, которая возникла при выполнении запроса на проверку ЭП

...

Опис причини появи помилки, яка виникла при виконанні запиту на перевірку ЕП
Приклад коду на JavaScript + jQuery 2.2.4
Code Block
languagejs
var settings = {
  "url": "https://ccs-dev-api.cipher.kiev.ua/ccs/api/v1/ticket/17321eef-de32-43e8-b1f6-1c4d0a2612d4/keyStore/certificate/base64/signature",
  "method": "PUT",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer {{token}}"
  },
  "data": JSON.stringify({
    "keyStorePassword": "12345678"
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

...