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

Для работы с разрешением используется 128-битное значение вида xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, где x-цифра(буква) шеснадцатиричной системы счисления.

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

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

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

Метод

POST

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

Отсутствуют

Настраиваемые заголовки запроса
Content-Typeapplication/json
Параметры JSON объекта запроса
ИмяТипОписание
accessTimesNumber
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
$.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;
    }
})