HTTP-инструменты
Если для сервиса нет плагина, опишите один HTTP-запрос — и бот сможет его вызывать. Откройте каталог плагинов и выберите Свой HTTP-инструмент в разделе Свои.
Инструмент состоит из:
- Названия и описания — по описанию бот понимает, когда инструмент нужен.
- Метода —
GET,POST,PUT,PATCHилиDELETE. - URL — может содержать подстановки, например
https://api.example.com/orders/{orderId}. - Параметров — у каждого есть имя, тип (
string,numberилиboolean), описание и признак обязательности.
Как собирается запрос
Заголовок раздела «Как собирается запрос»- Параметры, названные в URL, заполняют свои
{подстановки}. - Остальные идут в строку запроса для
GETиDELETEили в JSON-тело для других методов. - Бот получает код ответа и до 10 000 символов тела ответа.
Инструменты принадлежат пространству. Каждый бот получает все инструменты, разрешённые
роли человека, для которого он работает: по умолчанию GET, остальные методы — когда
роли дан write. См. API инструментов.