Если у сервиса есть REST API, его можно подключить к автоматизации без отдельного коннектора. Разберём, как делается интеграция через REST API в n8n с помощью узла HTTP Request — от первого запроса до production-ready связки с аутентификацией и обработкой ошибок.
Что такое интеграции REST API
REST API — это способ обмена данными между сервисами по протоколу HTTP: вы отправляете запрос (GET, POST, PUT, DELETE) на эндпоинт и получаете ответ в JSON. Интеграции rest api универсальны: так подключаются CRM, платёжные системы, мессенджеры и внутренние сервисы компании.
В n8n для этого есть узел HTTP Request — он закрывает 90% случаев, когда готового коннектора нет.
Шаг 1. Первый запрос через HTTP Request
- Добавьте узел HTTP Request.
- Укажите метод (
GET/POST) и URL эндпоинта. - Для тела запроса выберите
JSONи передайте данные из предыдущих узлов через выражения{{ $json.field }}.
POST https://api.service.com/v1/orders
Body (JSON): { "client": "{{ $json.name }}", "sum": {{ $json.amount }} }
Шаг 2. Аутентификация
Большинство API требуют авторизацию. В n8n создайте Credential нужного типа:
| Тип | Когда использовать |
|---|---|
| Header Auth | API-ключ в заголовке (Authorization: Bearer ...) |
| Basic Auth | логин/пароль |
| OAuth2 | Google, соцсети, крупные SaaS |
| Query Auth | ключ в query-параметре |
Не храните ключи прямо в узле — используйте Credentials, чтобы не светить секреты в экспорте workflow.
Шаг 3. Пагинация и лимиты
Если API отдаёт данные постранично, включите Pagination в HTTP Request: укажите параметр страницы и условие остановки. Для rate limits добавьте узел Wait между запросами, чтобы не словить 429 Too Many Requests.
Шаг 4. Обработка ошибок
Production-интеграция обязана переживать сбои:
- включите Retry On Fail на узле (2–3 попытки с задержкой);
- добавьте ветку Error Trigger для уведомления в Telegram/почту;
- проверяйте код ответа:
{{ $response.statusCode }}.
Проектирование интеграции через REST API
Перед сборкой опишите контракт: какие эндпоинты, какие поля, как авторизация, какие коды ошибок. Грамотное проектирование интеграции с rest api экономит часы отладки. Подробно об архитектуре и безопасности — в статье о проектировании интеграций и Vault.
Вывод
Узел HTTP Request делает интеграции rest api доступными без программиста: запрос, аутентификация через Credentials, пагинация и retry. Если нужен готовый коннектор — смотрите обзор интеграций n8n.