Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

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

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

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

URL-

...

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

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

Метод

POST

...

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

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

...

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

...

запиту
Content-Typeapplication/json
Параметры JSON объекта запроса
Параметри JSON об'єкта запиту
Ім'я
Имя
Тип
Описание
ОписДопустимі значення

accessTimesNumber

Number
Количество
Кількість раз
использования ЭЦП
використання ЕП, на
которые будет
яку буде запрошено
разрешение у пользователя
Ответ
розширення у користувача.

metaData

StringДодаткова інформація про підписуванні дані.Текстовий рядок. Можна використовувати HTML розмітку.

prefViewWidth

NumberШирина діалогового вікна, в якому буде розміщена додаткова інформація про підписані дані.

prefViewHeight

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

...

languagejs

...

Ідентифікатор створеного розширення
Приклад використання HTML розмітки для відображення додаткової інформації при створенні розширення на використання ЕП.

...