У випадку отримання Сервісом запиту на створення розширення на використання ЕП, Сервіс за допомогою діалогового вікна запитує у користувача розширення на використання ЕП деяку кількість разів.
Для роботи з розширенням використовується 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 |
Количество использования ЭП которые будет разрешение пользователя Дополнительная информация об подписываемых данных| Додаткова інформація про підписуванні дані. |
Текстовая строка. Возможно использовать HTML разметку | | Текстовий рядок. Можна використовувати HTML розмітку. |
prefViewWidth | Number | Ширина |
диалогового окна, в котором будет размещаться дополнительная информация о подписываемых данных.| діалогового вікна, в якому буде розміщена додаткова інформація про підписані дані. |
|
Высота диалогового окна, в котором будет размещаться дополнительная информация о подписываемых данных. | | Ответ
| Висота діалогового віна, в якому розміщується додаткова інформація про підписувані дані. |
|
Відповідь
Код ответа| Допустимые параметры | Пример содержимого| Допустимі параметри | Приклад вмісту |
|---|
| 200 | application/json | message | { "message" : " |
ЗапросиспользованиеЭПуспешнообработанКоличествопопытокспроб: 2.",
"accessTokenUuid" :"85a3bdd5-9b5e-4bc6-8e7b-447a583b7139" } |
| 403 | application/json | message | { |
ЗапросиспользованиеЭПотклоненпользователемкористувачем." } |
| 400 | application/json | message | { |
ЗапросиспользованиеЭПсодержитнеправильныйпараметрапараметру "accessTimesNumber"." } |
| 503 | application/json | message | {
|
Сервисхраненияданныхзапущен ...
Параметри JSON об'єкта відповіді
данныхОписаниеОписание результата проведения операции| Опис результату проведення операції |
| accessTokenUuid | String |
Идентификатор созданного разрешения | Пример кода на JavaScript + jQuery 2.2.4
| Code Block |
|---|
|
$.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;
}
}) |
...
| Ідентифікатор створеного розширення |
