Външна свързаност (External Connectivity)

Какво представлява External Connectivity?

External Connectivity ви дава възможност да свържете Reservation.Studio с външни приложения и услуги по структуриран и стандартизиран начин. Чрез тази функционалност получавате достъп до актуални данни, автоматизирате операции и разширявате обхвата на вашия бизнес софтуер.

Съвет

Поддържа се комуникация по стандарт JSON:API – една от най-популярните и лесни за интеграция архитектури за RESTful API, както и изпращане на уеб известия (webhooks) при определени събития.

---

Какво е JSON:API интеграция?

Основни предимства:

• Осигурява структуриран достъп до всички ключови ресурси на системата ви (четене, създаване, промяна, изтриване на данни).
• Унифициран подход за заявки и отговори – цялата комуникация се осъществява в JSON формат и следва стандарта на jsonapi.org.
• Лесна интеграция с външни и вътрешни системи, мобилни приложения и автоматизирани процеси.

Как да използвате JSON:API?

1. Аутентикация и сигурност

   • Достъпът до API се осигурява със сигурни API ключове (или OAuth, според конфигурация).
   • Всеки потребител или интеграция може да притежава собствен ключ с определени права.

2. Операции

   • Можете да извършвате заявки от тип GET, POST, PATCH, DELETE към описани ресурси.
   • Поддържат се филтриране на резултати, сортиране, странициране и включване на свързани обекти.

   Пример:

   GET /api/v1/resources?filter[status]=active
   Accept: application/vnd.api+json
   Authorization: Bearer <ВАШИЯТ_API_КЛЮЧ>

   Отговор:

   {
     "data": [
       {
         "type": "resource",
         "id": "1",
         "attributes": {
           "name": "Примерен ресурс",
           "status": "active"
         }
       }
     ]
   }

---

Как работят Webhooks?

Webhooks ви дават възможност да получите известие във външна система в реално време, когато настъпи определено събитие (например създаване на нов потребител, актуализиране на данни и др.).

Основни стъпки

1. Конфигурирайте webhook URL
   В секцията на администраторския панел задайте URL адрес, на който външната система ще приема известия.

2. Получаване на съобщения
   При събитие системата ще изпрати POST заявка с подходящ JSON payload:

   {
     "event": "user.created",
     "timestamp": "2024-06-10T14:00:00Z",
     "data": {
       "id": 123,
       "email": "user@example.com"
     }
   }

3. Обработка на събития
   Получената информация може автоматично да отключва действия във външната система – например създаване на потребителски профил и др.

---

Предимства

• Автоматизация и интеграция – връзка с външни услуги, системи за плащания, CRM, ERP, BI инструменти и др.
• Надеждност – поддръжка на стандартизиран JSON:API протокол и устойчиви webhook механизми.
• Мащабируемост – подходящо както за малки интеграции, така и за големи корпоративни архитектури.

---

Често задавани въпроси

Какви системи могат да бъдат интегрирани?

Всички, които поддържат RESTful API или могат да получават HTTP POST заявки с JSON данни.

Необходима ли е специална конфигурация?

Достатъчно е да генерирате API ключ по стандартни стъпки и да разполагате с външна система, която може да обработва изпратените JSON webhook-и.

Може ли да се управляват достъпите?

Да, системата поддържа управление на права и ограничения по ключ и потребител.

---

Бележка

За допълнителна информация относно интеграцията с външни системи и техническа помощ при внедряване, моля свържете се с нашия екип.