HTTP-запрос (http_request)
Функция http_request отправляет HTTP-запросы к внешним API и сервисам. Это базовый блок для интеграций — на его основе работают CRM, базы данных и другие подключения.
Параметры
| Параметр | Описание | Обязательный |
|---|---|---|
url |
Адрес API-эндпоинта | Да |
method |
HTTP-метод (GET, POST) | Нет (по умолчанию GET) |
headers |
Заголовки запроса (JSON) | Нет |
body |
Тело запроса (JSON, только для POST) | Нет |
save_as |
Имя переменной для сохранения ответа | Нет |
Примеры
GET-запрос
Получение данных из внешнего API:
url: https://api.example.com/users/123
method: GET
save_as: user_data
После выполнения результат доступен как {=user_data=}.
POST-запрос
Отправка данных:
url: https://api.example.com/orders
method: POST
headers: {"Content-Type": "application/json", "Authorization": "Bearer {=api_token=}"}
body: {"name": "{=tgData.from.first_name=}", "message": "{=message=}"}
save_as: order_result
Использование переменных
В URL, заголовках и теле запроса можно использовать переменные:
url: https://api.example.com/users/{=tgData.from.id=}
headers: {"Authorization": "Bearer {=token=}"}
Работа с ответом
Ответ сохраняется в указанную переменную. Если ответ в формате JSON, доступ к вложенным полям через точку:
{=user_data.name=}
{=user_data.email=}
{=order_result.status=}
Интеграции на базе HTTP-запроса
Для популярных сервисов есть готовые интеграции с преднастроенными параметрами: