page title decoration image

Руководства по Rillsoft Integration Server

Руководства по Rillsoft Integration Server

В этом разделе собраны практические шаги вокруг Rillsoft Integration Server: от первичной настройки и аутентификации до миграции существующих SOAP-интеграций на современный REST API v2.

Установка Integration Server

Integration Server работает как Linux-сервис. Сейчас непосредственно описаны два дистрибутива:

После успешной установки REST API доступен по настроенному базовому URL (пример: https://app.rillsoft.cloud).

Аутентификация в REST API

API работает исключительно с Bearer-токенами. Типовой сценарий:

  1. Вход через POST /api/v2/login с логином и паролем.
  2. Передача возвращённого токена в заголовке Authorization последующих вызовов: Authorization: Bearer <token>.
  3. Ротация или обновление токена до истечения срока действия.

Подробности по схемам и обязательным полям — в Справочнике API.

Миграция с SOAP-вебсервиса на REST API v2

Если в продуктивной среде ещё используется старый SOAP-вебсервис, переход стоит планировать вместе с обновлением до Rillsoft Project 10 — релиза, в котором интеграционный слой был полностью переведён на REST и выпущен как API v2. Рекомендованный порядок:

  1. Инвентаризация текущих SOAP-вызовов — какие операции, какие поля, какие объёмы данных.
  2. Сопоставление с REST-эндпоинтами — за источник истины брать Справочник API v2.
  3. Перевод аутентификации — WS-Security уходит, вместо него поток с Bearer-токеном.
  4. Проверка JSON-модели данных — имена полей, форматы дат и UUID местами отличаются от старой XML-схемы.
  5. Постепенная миграция — v1 остаётся параллельно, новые подключения сразу строить на v2.

Типовые сценарии интеграции

  • Интеграция с ERP: регулярная синхронизация мастер-данных (сотрудники, проекты, клиенты).
  • Интеграция с HR: согласование отпусков и отсутствий между HR-системой и Rillsoft Project.
  • BI / отчётность: передача агрегированных данных из дашборд-эндпоинтов в Tableau, Power BI или Looker.
  • Интеграция с DMS: автоматическое прикрепление документов из сторонних систем к проектам или задачам.
  • Собственные веб- или мобильные клиенты: лёгкие фронтенды без установки толстого клиента.

Запланированные дополнения

  • Пошаговые примеры рабочих процессов (Postman, cURL).
  • Эталонные реализации на Python, Java и .NET.
  • Заметки по rate limits, постраничному выводу и обработке ошибок.
  • Практическое руководство по миграции отдельных SOAP-операций на REST.