Versions Compared

Key

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

При получении запроса на выработку ЭЦП создание ЭП Сервис посредством диалогового окна запрашивает у пользователя однократное разрешение на использование ЭЦПЭП. Такое разрешение действительно в рамках одного запроса. В случае получения Сервисом запроса на создание разрешения на использование ЭЦП ЭП Сервис посредством диалогового окна запрашивает у пользователя разрешение на использование ЭЦП ЭП некоторое количество раз.  

...

Разрешение может использоваться как в одной так и в нескольких сессиях.

URL-адрес запроса

https://local.cipher.kiev.ua:9091/api/v1/accessToken

Метод

POST

Параметры запроса

Отсутствуют

Настраиваемые заголовки запроса
Content-Typeapplication/json
Параметры JSON объекта запроса
ИмяТипОписаниеДопустимые значения

accessTimesNumber

NumberКоличество раз использования ЭЦПЭП, на которые будет запрошено разрешение у пользователя. 

metaData

StringДополнительная информация об подписываемых данных.Текстовая строка. Возможно использовать HTML разметку.

prefViewWidth

NumberШирина диалогового окна, в котором будет размещаться дополнительная информация о подписываемых данных. 

prefViewHeight

NumberВысота диалогового окна, в котором будет размещаться дополнительная информация о подписываемых данных. 
Ответ
Код ответаContent-typeДопустимые параметрыПример содержимого
200application/jsonmessage
{
"message" : "Запрос на использование ЭЦПЭП успешно обработан. Количество попыток: 2.",
"accessTokenUuid" :"85a3bdd5-9b5e-4bc6-8e7b-447a583b7139"
}
403application/jsonmessage
{
    "message" : "Запрос на использование ЭЦПЭП отклонен пользователем."
}
400application/jsonmessage
{
    "message" : "Запрос на использование ЭЦПЭП содержит неправильный формат параметра "accessTimesNumber"."
}
503application/jsonmessage
{
    "message" : "Сервис хранения данных не запущен."
}
Параметры JSON объекта ответа
ПараметрТип данныхОписание
messageStringОписание результата проведения операции
accessTokenUuidStringИдентификатор созданного разрешения
Пример кода на JavaScript + jQuery 2.2.4
Code Block
languagejs
$.ajax({
    url: "https://local.cipher.kiev.ua:9091/api/v1/accessToken",
    type: "POST",
    dataType: "json",
    contentType: "application/json",
    data: JSON.stringify({accessTimesNumber: 2})
}).done(function (jsonResponse, textStatus, xhr) {
    message = jsonResponse.message;
    accessTokenUuid = jsonResponse.accessTokenUuid;
}).fail(function (xhr) {
    try {
        var jsonResponse = JSON.parse(xhr.responseText);
        message = jsonResponse.message;
    } catch (e) {
        message = (xhr.responseText == undefined) ? "Ошибка при получении разрешения на использование ЭЦПЭП." : xhr.responseText;
    }
})
Пример использования HTML разметки для отображения дополнительной информации при создании разрешения на использование ЭЦП.