n8n HTTP Request — как подключить любой API¶

Обновлено: 2026-05-29

n8n HTTP Request — это нода для отправки HTTP-запросов к внешним API прямо из workflow. Она используется в n8n для получения данных, создания записей, отправки событий и интеграции сервисов без готовой ноды. В этой статье: как настроить HTTP Request, передать авторизацию, отправить JSON, обработать ответ и избежать частых ошибок.

Что такое HTTP Request в n8n¶

HTTP Request в n8n — это универсальная нода для работы с REST API. Она отправляет запрос на указанный URL и возвращает ответ в виде данных workflow.

Нода заменяет готовую интеграцию, когда нужного сервиса нет в списке n8n. Она также полезна, когда готовая нода не поддерживает конкретный endpoint API.

Типовые задачи для HTTP Request:

• получить данные из CRM, таблицы, базы знаний или внутреннего сервиса;
• создать лид, сделку, заказ или задачу во внешней системе;
• отправить webhook-событие в другой backend;
• вызвать AI API, например OpenAI-compatible endpoint;
• проверить статус операции по ID.

Какие данные нужны для подключения API¶

Для подключения API через HTTP Request нужны endpoint, метод, авторизация и схема данных. Эти параметры обычно описаны в документации сервиса.

Минимальный набор:

Как настроить n8n HTTP Request пошагово¶

Настройка n8n HTTP Request начинается с выбора метода и URL. После этого добавляют авторизацию, параметры запроса и тело.

1. Открой workflow в n8n.
2. Нажми + на холсте.
3. Найди ноду HTTP Request.
4. В поле Method выбери HTTP-метод.
5. В поле URL вставь endpoint API.
6. В блоке Authentication выбери способ авторизации.
7. Включи Send Headers, если API требует заголовки.
8. Включи Send Body, если запрос отправляет данные.
9. Нажми Test step и проверь ответ.

Пример простого GET-запроса:

{
  "method": "GET",
  "url": "https://www.cbr-xml-daily.ru/daily_json.js"
}

После выполнения n8n сохранит ответ API в $json. Эти данные можно передать в следующую ноду.

Как выбрать HTTP-метод¶

HTTP-метод определяет действие, которое API выполнит с ресурсом. Метод нужно брать из документации endpoint.

Как передать авторизацию в HTTP Request¶

Авторизация в HTTP Request подтверждает, что workflow имеет право обращаться к API. Самые частые варианты — Bearer token, API key и Basic Auth.

Bearer token¶

Bearer token передают в заголовке Authorization.

Authorization: Bearer {{$env.API_TOKEN}}

В n8n это настраивается так:

1. Включи Send Headers.
2. Нажми Add Parameter.
3. В поле Name укажи Authorization.
4. В поле Value укажи Bearer {{$env.API_TOKEN}}.

API key¶

API key часто передают в заголовке или query-параметре.

X-API-Key: {{$env.EXAMPLE_API_KEY}}

Если документация просит query-параметр, добавь его в Send Query Parameters.

?api_key={{$env.EXAMPLE_API_KEY}}

Как отправить JSON в теле запроса¶

JSON в HTTP Request используют для создания или обновления данных через API. Для этого нужен метод POST, PUT или PATCH.

1. Выбери Method: POST.
2. Включи Send Body.
3. В поле Body Content Type выбери JSON.
4. В режиме Specify Body выбери Using JSON.
5. Вставь тело запроса.

{
  "title": "Позвонить клиенту",
  "priority": "high",
  "source": "n8n",
  "customerEmail": "{{$json.email}}"
}

Поле {{$json.email}} берёт email из входных данных текущей ноды. Подробнее о подстановках смотри в разделе Выражения.

Как использовать данные из предыдущих нод¶

Данные из предыдущих нод в HTTP Request вставляют через выражения n8n. Выражение позволяет собрать URL, заголовок или тело запроса динамически.

Пример URL с ID клиента:

https://api.example.com/v1/customers/{{$json.customerId}}

Пример query-параметра:

status={{$json.status}}

Пример JSON body:

{
  "name": "{{$json.name}}",
  "email": "{{$json.email}}",
  "utm_source": "{{$json.utm_source || 'unknown'}}"
}

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

Ответ HTTP Request становится JSON-данными для следующих нод workflow. Эти данные можно фильтровать, преобразовывать и отправлять дальше.

Частый сценарий:

1. HTTP Request получает список объектов.
2. If проверяет статус или наличие поля.
3. Set оставляет только нужные поля.
4. Telegram, Email или CRM-нода отправляет результат.

Пример обращения к полю ответа:

{{$json.data[0].id}}

Если API возвращает массив, проверь структуру ответа через Test step. Затем используй Split Out или Code node, если нужно обработать каждый элемент отдельно.

Частые ошибки HTTP Request в n8n¶

Ошибки HTTP Request чаще всего связаны с авторизацией, форматом JSON или неверным URL. Код ответа помогает быстро найти причину.

Пример: отправка лида в CRM через API¶

HTTP Request может отправить лид из формы в CRM без готовой интеграции. Для этого workflow принимает данные, собирает JSON и вызывает endpoint CRM.

Схема workflow:

1. Webhook принимает заявку с сайта.
2. Set нормализует имя, телефон и email.
3. HTTP Request отправляет данные в CRM.
4. If проверяет успешный статус ответа.
5. Telegram уведомляет менеджера.

{
  "name": "{{$json.name}}",
  "phone": "{{$json.phone}}",
  "email": "{{$json.email}}",
  "comment": "Заявка с сайта",
  "source": "website"
}

Для production-сценария добавь обработку ошибок. Базовые принципы описаны в разделе Обработка ошибок.

LLM-разметка статьи¶

LLM-разметка помогает поисковым и AI-системам извлекать из статьи точные ответы. Ниже собраны основные сущности и факты страницы.

{
  "topic": "n8n HTTP Request",
  "definition": "n8n HTTP Request — нода для отправки HTTP-запросов к внешним API из workflow.",
  "primary_use_cases": [
    "подключение REST API",
    "создание записей во внешних сервисах",
    "получение данных из API",
    "отправка webhook-событий"
  ],
  "required_parameters": [
    "URL",
    "HTTP method",
    "authentication",
    "headers",
    "query parameters",
    "body"
  ],
  "common_errors": ["400", "401", "403", "404", "429", "500"]
}

Часто задаваемые вопросы¶

Можно ли подключить любой API к n8n через HTTP Request?¶

Да. Если API доступен по HTTP и у тебя есть права доступа, его можно подключить через HTTP Request. Ограничения обычно связаны с авторизацией, rate limit или закрытой сетью.

Что делать, если HTTP Request возвращает 401?¶

401 означает ошибку авторизации. Проверь токен, формат заголовка Authorization, срок действия ключа и права доступа приложения.

Чем HTTP Request отличается от готовых нод n8n?¶

HTTP Request универсальнее готовой ноды. Готовая нода удобнее для типовых операций, а HTTP Request нужен для нестандартных endpoint и сервисов без интеграции.

Как не превысить лимит API?¶

Используй паузы, batching и retry-логику. Если API возвращает 429, уменьши частоту запросов и проверь лимиты в документации сервиса.

Где хранить API-ключи для HTTP Request?¶

API-ключи лучше хранить в credentials или переменных окружения. Не храни секреты в открытом тексте внутри workflow.

Связанные материалы¶

• Выражения в n8n — как подставлять данные из предыдущих нод.
• Работа с данными — как преобразовывать JSON между шагами workflow.
• Обработка ошибок — как строить устойчивые сценарии.
• Первый workflow за 10 минут — базовый пример с HTTP Request и Telegram.