Перейти к содержимому

HTTP-инструменты

Если для сервиса нет плагина, опишите один HTTP-запрос — и бот сможет его вызывать. Откройте каталог плагинов и выберите Свой HTTP-инструмент в разделе Свои.

Инструмент состоит из:

  • Названия и описания — по описанию бот понимает, когда инструмент нужен.
  • Метода — GET, POST, PUT, PATCH или DELETE.
  • URL — может содержать подстановки, например https://api.example.com/orders/{orderId}.
  • Параметров — у каждого есть имя, тип (string, number или boolean), описание и признак обязательности.
  1. Параметры, названные в URL, заполняют свои {подстановки}.
  2. Остальные идут в строку запроса для GET и DELETE или в JSON-тело для других методов.
  3. Бот получает код ответа и до 10 000 символов тела ответа.

Инструменты принадлежат пространству. Каждый бот получает все инструменты, разрешённые роли человека, для которого он работает: по умолчанию GET, остальные методы — когда роли дан write. См. API инструментов.