HTTP-запрос

Отправляйте данные во внешний API и используйте ответ в следующих блоках.

Инструменты → HTTP-запрос

Настройки

Поле / настройкаЧто указать
МетодGET, POST, PUT, PATCH, DELETE или HEAD. По умолчанию — GET.
URLПолный публичный HTTP(S)-адрес, без логина и пароля в самом адресе.
ЗаголовкиЗаголовки, которые требует внешний API.
Формат телаJSON либо форма application/x-www-form-urlencoded.
Тело · JSONJSON с данными; выражения внутри JSON пишутся строками.
Параметры формыДля формата формы — пары «Параметр» и «Значение».
Таймаут, секундОт 1 до 30. По умолчанию — 15.
Допустимые коды ответаДополнительные коды через запятую, например 404, 409. Все 2xx допустимы всегда.

Пример тела запроса

JSON
{
  "lead_id": "{{lead.id}}",
  "items": "{{ $json.items }}"
}

URL и заголовки возьмите из документации вашего сервиса. Этот пример задаёт только структуру данных; универсального рабочего адреса API у него нет.

Как обработать ответ

{{ $json.status }}
{{ $json.body }}

Если разрешили код 404, блок может передать такой ответ дальше без остановки исполнения. При этом поле результата success остаётся false, потому что HTTP-ответ не является 2xx. Используйте условие по статусу.

Безопасность и ограничения

ОграничениеПоведение
Внутренние адресаЗапросы во внутреннюю сеть запрещены.
РедиректыПерехода на другой адрес нет, даже если код 3xx разрешён.
РазмерТело JSON и ответ ограничены 1 МБ.
Таймаут / доступностьОшибка о недоступности сервера либо превышении времени.
ПовторыСам блок автоматически не повторяет HTTP-вызов.
GET и HEADТело запроса не отправляется.

Тестовый режим

При источнике запуска test или признаках dry-run/test-mode HTTP-запрос не отправляется. В выходе будет сообщение об имитации. Это не подтверждает, что внешний API принял ваши данные.

Редактор потоков
Редактор Потоков