Загальні принципи

 


Для автоматизованого отримання/передачі інформації з бази даних УБКІ необхідно розробити спеціалізоване програмне забезпечення, яке буде здійснювати побудову і відправку запиту на web-сервіс УБКІ згідно поточної специфікації, потім отримувати дані і представляти їх у вигляді, необхідному для Вашого завдання. Web-сервіс УБКІ приймає запити, обробляє і надає відповідь в залежності від типу запиту.


Вступні вимоги

  • Transport security - протокол HTTPS;

  • Method - POST;

  • Headers - Content-Type: application/xml або Content-Type: application/json, а також додатковий заголок, при передачі даних, при користуванні base64 - у заголовку пакету необхідно вказувати Content-Type: application/xml+base64, при користуванні у форматі gzip - Content-Encoding: gzip;

  • Security Schemes - діючий сесійний ключ, отриманий через сервіс авторизації;

  • Encoding - UTF-8;

  • Performance - час проміжку між запитами - 5 секунд, час тайм-ауту (відповіді) - 60 секунд;

  • Request & response parameters - всі значення тегів і атрибутів повинні бути екрановані і відфільтровані для уникнення в тексті спецсимволів, що призводять до руйнування xml-документа і помилки обробки веб-сервісом (наприклад, функцією php htmlspecialchars ()). Значення атрибутів повинні бути обрамлені подвійними лапками і не допускати появи їх в тексті;

Формування запиту

Запит на основний web-сервіс має два види:

  • запит на пошук і отримання звіту;

  • запит на передачу даних.

Специфікація запиту на основний web-сервіс є опціональною (уніфікованою), яка дозволяє реалізувати обидва режими роботи (отримання/передача). Режим роботи web-сервіс визначає автоматично за наявністю тегів, що відповідають за той чи інший режим роботи.


Авторизація

Отримання інформації із бюро

Передача інформації в бюро

Моніторинг

Тестове середовище

Довідники

Журнал змін

 

Якщо у Вас виникли питання, будь ласка, звертайтесь на support@ubki.ua.