HTTP Request в n8n: REST API, headers, body и auth ¶
Обновлено: 2026-05-29
HTTP Request — универсальная нода для подключения сервисов, у которых нет готовой интеграции или встроенная нода не покрывает нужный endpoint. Если вы умеете читать API-документацию, эта нода закрывает большинство нестандартных задач.
Перед настройкой ¶
Определите URL, method, auth, headers, query parameters, body и формат response. Сначала найдите рабочий пример в документации API или проверьте запрос через curl/Postman, потом переносите в n8n.
Методы и body ¶
GET получает данные, POST создаёт, PATCH/PUT обновляет, DELETE удаляет. Для JSON API обычно нужны headers Content-Type: application/json и Authorization. Токен храните в credentials, а body собирайте из нормализованных полей.
Pagination ¶
Многие API возвращают не все данные сразу. Проверьте тип pagination: page/limit, offset, cursor или next URL. Без этого workflow silently обработает только первую страницу.
Ошибки ¶
401 — авторизация, 403 — права, 404 — endpoint или id, 429 — лимит, 5xx — проблема сервиса. Для временных ошибок добавляйте retry, для логических — alert и исправление данных.
Инженерный контракт для кода в n8n ¶
Статья HTTP Request в n8n: REST API, headers, body и auth должна помогать писать код, который не ломает data flow. До Code node нормализуйте вход, внутри кода явно обрабатывайте пустые поля и arrays, после кода возвращайте предсказуемый JSON. Если количество output items отличается от input items, отдельно проверьте item linking.
- не храните secrets в коде: используйте credentials или env, если это допустимо в вашей схеме
- не смешивайте парсинг, бизнес-решение и HTTP-вызов в одном фрагменте без причины
- оставляйте примеры входа/выхода рядом с workflow или в комментарии
- для production добавляйте тесты на пустой, частичный и неожиданный payload
- если выражение можно сделать без Code node — сначала оцените более простую ноду
Практический контекст для внедрения ¶
Эта страница полезна не как абстрактная справка, а как рабочая инструкция под тему «HTTP Request в n8n: REST API, headers, body и auth» в практическом внедрении n8n. Перед изменением workflow зафиксируйте источник события: HTTP/Webhook событие от внешней системы с подписью, timestamp и payload. Так проще отделить ошибку данных от ошибки настройки n8n и не превратить исправление в набор случайных правок.
Для production-версии заранее назначьте владельца процесса, точку восстановления и критерий успешного запуска. Главный риск для этой темы: повторная доставка, неверный статус ответа, большие payload, отсутствие idempotency key. Его лучше закрывать не дополнительными нодами, а явным контрактом входных данных, idempotency-ключом, логированием решения и отдельной веткой обработки ошибок.
| Слой | Что проверить | Почему это важно |
|---|---|---|
| Вход | payload, внешний ID, timestamp, источник события | без этого невозможно отличить новый item от повтора |
| Логика | условия IF/Switch, mapping полей, fallback | ошибка часто появляется не в ноде, а в переходе между ветками |
| Выход | статус операции, запись audit trail, ссылка на execution | после запуска нужно быстро понять, что workflow сделал с конкретным объектом |
| Эксплуатация | status code distribution, retry count, payload size, dedupe hit rate | метрики показывают деградацию раньше, чем пользователи начинают жаловаться |
Как проверить качество страницы на практике ¶
- Соберите один тестовый пример по теме «HTTP Request в n8n: REST API, headers, body и auth» и прогоните его через workflow вручную.
- Проверьте пустой вход, повтор того же события и ошибку внешнего API.
- Убедитесь, что в execution видно решение workflow: почему ветка была выбрана и какой внешний объект изменён.
- Добавьте ссылку на эту страницу в runbook, если сценарий будет поддерживать не только автор автоматизации.
Что читать дальше ¶
Справочник по самой ноде — HTTP Request node, по auth — credentials.
Чеклист кода ¶
Код в n8n должен уменьшать сложность, а не прятать бизнес-логику. Если задачу можно ясно решить через Set, IF или Switch, лучше оставить её визуальной. Code node стоит использовать для массивов, агрегатов, сложного форматирования и нестандартных API-подписей.
- На выходе всегда массив items с полем
json. - Секреты берутся из credentials, а не из текста кода.
- Ошибки и пустые поля обработаны явно.
- После Code node проверен item linking, если дальше используются данные предыдущих нод.
Как тестировать ¶
Проверяйте код минимум на трёх входах: обычный item, item с пустыми необязательными полями и item с неожиданным типом данных. Это быстрее, чем разбирать production execution после того, как внешний API прислал новый формат ответа.