У випадку отримання Сервісом запиту на створення розширення на використання ЕП, Сервіс за допомогою діалогового вікна запитує у користувача розширення на використання ЕП деяку кількість разів.
Для роботи з розширенням використовується 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.", } | |
| 403 | application/json | message | {"message" : "ЗапросЗапит на использованиевикористання ЭПЕП отклоненвідхилено пользователемкористувачем." } | |
| 400 | application/json | message | {"message" : "ЗапросЗапит на использованиевикористання ЭПЕП содержитмістить неправильныйнеправильний формат параметрапараметру "accessTimesNumber"." } | |
| 503 | application/json | message | { |
...
Параметри JSON об'єкта відповіді
| Параметр | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| message | String | Описание результата проведения операцииОпис результату проведення операції |
| 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;
}
}) |
...
Приклад використання HTML
...