Завантажити ключ

URI: /api/v1/key

Метод використовується для завантаження ключа електронного цифрового підпису (ЕЦП) на сервер.

Запит виконується методом POST з даними у вигляді HTML-форм.

⚠️ Запит повинен містити заголовок Accept: application/json

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

Ім'я	Тип	Обов'язковий	Опис
key	file	Так	Файл ключа ЕЦП, який необхідно завантажити на сервер
pass	string	Так	Індивідуальний пароль доступу до ключа

Параметри відповіді

Ім'я	Тип	Опис
uuid	string	Унікальний ідентифікатор ключа ЕЦП
serial	string	Серійний номер сертифіката ЕЦП
drfo	string	Реєстраційний номер облікової картки платника податків
public_key	string	Відкритий ключ, який використовується для перевірки електронного підпису
message	string	Повідомлення з текстом помилки

Приклад успішної відповіді

Успішна операція

200 OK

Відповідь: /api/v1/key

{
    "uuid": "9d4994df-cf3e-40c6-a022-d1bc635dc32c",
    "serial": "58E2D9E7F900307B040000000CAB2500DA8A7A00",
    "drfo": "1010101017",
    "public_key": "a6b1f3ffe570744bf13e4d0f07da15b086350ec82d3882852dd7249d8aab6bfc"
}

Приклади неуспішних відповідей

Ключ вже існує

400 Bad Request

Відповідь: /api/v1/key

{
    "message": "Key already exist",
    "serial": "0000000000000000000000000000000000000001"
}

Сертифікат не знайдено

400 Bad Request

Відповідь: /api/v1/key

{
    "message": "Сертифікат не знайдено"
}

Невірний пароль або пошкоджений ключ

400 Bad Request

Відповідь: /api/v1/key

{
    "message": "Виникла помилка при відкритті особистого ключа (невірний пароль чи ключ пошкоджений)"
}