Керування сервісами REST
Головною вимогою до сервісу, що буде публікуватись в ШБО і викликатись за домомогою REST API через ШБО, є його повна доступність для реєстрового ШБО через адресу та порт, що буде використовуватись при публікації сервісу. Враховуючи, що сервіс, що буде публікуватись, розгортатиметься в тому ж namespace платформи що і ШБО, він буде доступний для ШБО по внутрішньому доменному імені.
1. Додавання REST API
Коли додається новий REST API, шлюз безпечного обміну інкапсулює його в єдиний сервіс в системі "Трембіта" і відображає його в таблиці сервісів, що базуються на REST API.
Щоб додати REST API, виконайте наступні дії:
-
в меню Конфігурація виберіть Клієнти шлюзу безпечного обміну, далі виберіть клієнта з таблиці і клацніть значок REST APIs у цьому рядку;
-
натисніть Додати REST API, введіть базову URL-адресу і код сервісу у вікні, яке відкриється, і натисніть OK. Базова URL-адреса і код сервісу в системі "Трембіта", що відповідає REST API, додаються до таблиці.
-
за замовчанням REST API додано у вимкненому стані, тому після додавання нового REST API його потрібно ввімкнути. Для цього оберіть щойно доданий REST API і натисніть кнопку Ввімкнути.
3. Приклад виклику сервісу через REST API
Можна використати будь який REST клієнт. Приклад запиту в Postman:
{
"info": {
"_postman_id": "3eaa3683-1204-43fa-9010-00586c778334",
"name": "Trembita Rest",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "https://trembita.mdtu-ddm.projects.epam.com/restapi",
"request": {
"method": "GET",
"header": [
{
"key": "Uxp-client",
"value": "SEVDEIR-TEST/GOV/43395033/DDMTest_prod",
"type": "text"
},
{
"key": "Uxp-service",
"value": "SEVDEIR-TEST/GOV/43395033/DDMTest_prod/restApi/v1",
"type": "text"
}
],
"url": {
"raw": "https://trembita.mdtu-ddm.projects.epam.com/restapi",
"protocol": "https",
"host": [
"trembita",
"mdtu-ddm",
"projects",
"epam",
"com"
],
"path": [
"restapi"
]
},
"description": "ww"
},
"response": []
}
]
}