Додавання нового ключа

Запит виконується методом POST у json або urlencoded форматі.

URI: /api/v1/key

Підтримуються два типи ключів: file (файловий) та cloud (хмарний).

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

Ім'я	Тип	Обов'язковий	Опис
type	string	Ні	Тип ключа: file — файловий (за замовчуванням) cloud — хмарний Якщо параметр не передано — вважається file
key	string	Так, для file	Шлях до файлу ключа. Для хмарного ключа не передається
publisher	string	Так	Видавець ключа (брати строго зі списку видавців)
pass	string	Так	Пароль до ключа
inn	string	Ні, для cloud	ІПН власника ключа фізичної особи, ЄДРПОУ — для юрособи. Якщо не передано — використовується значення edrpou
edrpou	string	Так, для cloud	Код ЄДРПОУ організації
serial	string	Так, для cloud	Серійний номер ключа

Увага!

Для файлового ключа (type = "file"):

• обов'язкові key, publisher, pass
• поля хмарного ключа (inn, edrpou, serial) можна не передавати

Для хмарного ключа (type = "cloud"):

• обов’язкові publisher, pass, edrpou, serial
• поле key не передається і не використовується

Приклад запиту для файлового ключа

Запит: /api/v1/key

{
  "type": "file",
  "key": "c:\\test.dat",
  "publisher": "КНЕДП ДПС",
  "pass": "111"
}

Приклад запиту для хмарного ключа

Запит: /api/v1/key

{
  "type": "cloud",
  "publisher": "КНЕДП \"eSign\" ТОВ \"Ілайф\"",
  "pass": "222222",
  "inn": "21032333",
  "edrpou": "21032333",
  "serial": "011555"
}

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

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

{
    "message": "OK"
}

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

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

{
  "message": "Відсутній файл: c:\\test.dat",
  "code": "A004"
}

Список видавців

• КНЕДП ДПС
• "Дія". Кваліфікований надавач електронних довірчих послуг
• КНЕДП ЦСК Укрзалізниці
• КНЕДП "MASTERKEY" ТОВ "АРТ-МАСТЕР"
• КНЕДП ДП "УСС"
• КНЕДП АТ "УКРСИББАНК"
• КНЕДП АЦСК АТ КБ "ПРИВАТБАНК"
• КНЕДП АЦСК АТ "Альфа-Банк"
• КНЕДП АТ "СЕНС БАНК"
• КНЕДП Акціонерного товариства “КРЕДІ АГРІКОЛЬ БАНК”
• КНЕДП АТ "ПУМБ"
• КНЕДП ТОВ "ДЕПОЗИТ САЙН"
• КНЕДП ТОВ "Вчасно Сервіс"
• КНЕДП “ЦСК Збройних Сил України”
• КНЕДП "Військова частина 2428" ДПСУ
• КНЕДП "АЦСК ринку електричної енергії"
• КНЕДП - АЦСК МВС України
• КНЕДП Служби зовнішньої розвідки України
• АЦСК Національного банку України
• КНЕДП АТ "ПРАВЕКС БАНК"
• КНЕДП АТ "ТАСКОМБАНК"
• КНЕДП ТОВ "Центр сертифікації ключів "Україна"
• КНЕДП Казначейства
• КНЕДП АТ "Ощадбанк"
• КНЕДП органів прокуратури України
• КНЕДП СБ України
• КНЕДП ЦЕЗАРІС TOB "Інтер-Метл"
• КНЕДП "eSign" ТОВ "Ілайф"
• КНЕДП АТ "БАНК АЛЬЯНС"
• КНЕДП АБ "УКРГАЗБАНК"