View Source

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

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

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

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

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

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

Метод

POST

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

Отсутствуют

Настраиваемые заголовки запроса

Content-Type

application/json

Параметры JSON объекта запроса

Имя	Тип	Описание	Допустимые значения
accessTimesNumber	Number	Количество раз использования ЭП, на которые будет запрошено разрешение у пользователя.
metaData	String	Дополнительная информация о подписываемых данных.	Текстовая строка. Возможно использовать HTML разметку.
prefViewWidth	Number	Ширина диалогового окна, в котором будет размещаться дополнительная информация о подписываемых данных.
prefViewHeight	Number	Высота диалогового окна, в котором будет размещаться дополнительная информация о подписываемых данных.

Ответ

Код ответа	Content-type	Допустимые параметры	Пример содержимого
200	application/json	message	{ "message" : "Запрос на использование ЭП успешно обработан. Количество попыток: 2.", "accessTokenUuid" :"85a3bdd5-9b5e-4bc6-8e7b-447a583b7139" }
403	application/json	message	{ "message" : "Запрос на использование ЭП отклонен пользователем." }
400	application/json	message	{ "message" : "Запрос на использование ЭП содержит неправильный формат параметра "accessTimesNumber"." }
503	application/json	message	{ "message" : "Сервис хранения данных не запущен." }

Параметры JSON объекта ответа

Параметр	Тип данных	Описание
message	String	Описание результата проведения операции
accessTokenUuid	String	Идентификатор созданного разрешения

Пример кода на 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;
    }
})