Page History

У випадку отримання Сервісом запиту на створення розширення на використання ЕП, Сервіс за допомогою діалогового вікна запитує у користувача розширення на використання ЕП деяку кількість разів.

Для роботи з розширенням використовується 128-бітне значення виду

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

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

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

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

URL-

...

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

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

Метод

POST

...

Параметри запиту

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

...

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

...

запиту

Content-Type

application/json

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

Параметри JSON об'єкта запиту

Ім'яИмя	Тип	ОписаниеОпис	Допустимые значенияДопустимі значення
accessTimesNumber	Number	Количество Кількість раз использования ЭПвикористання ЕП, на которые будет яку буде запрошено разрешение розширення у пользователякористувача.
metaData	StringДополнительная	информация о подписываемых данныхДодаткова інформація про підписуванні дані.	Текстовая строка. Возможно использовать HTML разметкуТекстовий рядок. Можна використовувати 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

Code Block

language	js

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

...

Ідентифікатор створеного розширення

Page tree

Versions Compared

Old Version 9

New Version Current

Key