У випадку отримання Сервісом запиту на створення розширення на використання ЕП, Сервіс за допомогою діалогового вікна запитує у користувача розширення на використання ЕП деяку кількість разів.
Для роботи з розширенням використовується 128-бітне значення виду xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, де x-цифра(буква) шістнадцятирічної системи числення.
Розширення може використовуватися як в рамках однієї так і кількох сесій.
URL-адреса запиту
Метаданные используются для предоставления пользователю дополнительной информации в случае запроса на разрешение использования ЭЦП. Для внутреннего форматирования метаданных возможно использовать HTML разметку.
Данные сессии, для которых будут производиться операции ЭЦП и МБ, должны быть обязательно загружены перед установкой метаданных.
...
https://local.cipher.kiev.ua:9091/api/v1/ticket/{uuid}/metadataaccessToken
Метод
PUTPOST
...
Параметри запиту
| uuid | String | Идентификатор сессии |
Відсутні
Налаштовувані заголовки запиту
...
| Content-Type | application/json |
Параметры JSON объекта запроса
Параметри JSON об'єкта запиту
| Ім'я | Тип | Опис | Допустимі значення |
|---|---|---|---|
accessTimesNumber | Number | Кількість раз використання ЕП, на яку буде запрошено розширення у користувача. |
metaData | String |
Ответ
| Додаткова інформація про підписуванні дані. | Текстовий рядок. Можна використовувати HTML розмітку. | ||
prefViewWidth | Number | Ширина діалогового вікна, в якому буде розміщена додаткова інформація про підписані дані. | |
prefViewHeight | Number | Висота діалогового віна, в якому розміщується додаткова інформація про підписувані дані. |
Відповідь
| Код відповіді |
|---|
| Content-type |
|---|
| Допустимі параметри | Приклад вмісту | ||
|---|---|---|---|
| 200 | application/json | message | { |
"message" : |
}
"Запит на використання ЕП успішно оброблений. Кількість спроб: 2.", } |
| 403 |
| application/json | message | { |
"message" : |
"Запит на використання ЕП відхилено користувачем." } | |||
| 400 | application/json | message | { |
"message" |
}
Параметры JSON объекта ответа
| Параметр | Тип данных | Описание |
|---|---|---|
| message | String | Описание результата проведения операции |
Пример кода на JavaScript + jQuery 2.2.4
...
| language | js |
|---|
...
|
...
: " |
...
Запит на використання ЕП містить неправильний формат параметру "accessTimesNumber"." } | |||
| 503 | application/json | message | { |
Параметри JSON об'єкта відповіді
| Параметр | Тип даних | Опис |
|---|---|---|
| message | String | Опис результату проведення операції |
| accessTokenUuid | String | Ідентифікатор створеного розширення |