Обработка запроса в служебном сценарии канала интеграции

Обзор

Позволяет использовать служебные сценарии в качестве обработчиков HTTP-запроса.

Запросы

HTTP verb Endpoint Описание

GET

POST

/api/token/v1/:TOKEN

Проектное API в служебном сценарии

GET

POST

Проектное API в служебном сценарии

В URL участвует токен. Иначе он должен быть указан в заголовке "Authorization: Bearer TOKEN_LOCAL" По значению токена опеределяется домен, канал интеграции которого используется, и служебный сценарий которого обрабатывает запрос.

Канал интеграции должен иметь тип 'public' и ему должен быть назначен служебный сценарий обслуживания входящих запросов (recv_svcscriptcode]). Запрос может обрабатываться синхронно или асинхронно (определяется свойством opts.issync). А также с ограничением по времени исполнения (определяется свойством opts.recv_timeout канала интеграции). Канал интеграции может быть ограничен обработкой запросов с конкретного ip4-адреса, маски адресов либо диапазона ip4-адресов.

В запрос могут быть добавлены произвольные параметры.

Сценарий обработки запроса принимает следующие параметры:

  1. JSON - сущность канала интеграции.

  2. Метод (GET, POST, …​).

  3. Url.

  4. Тело запроса.

  5. Заголовки запроса.

  6. Ip4 адрес отправителя запроса.

  7. Протокол запроса

Запрос

Примеры запроса
GET /api/token/v1/a55c54b59ee6c8cfab2f83e33c2474d3 HTTP/1.1

Ответ

Ответ зависит от алгоритма связанного служебного сценария и значений локальных переменных со специальными именами.

Может быть установлены произвольный код ответа (response_code), заголовки (response_headers), тело (response_content).