HTTP Request node — один из самых универсальных узлов в Нейро42. Он позволяет выполнять HTTP-запросы к любому приложению или сервису с REST API и получать данные для обработки в workflow.
Связанные ресурсы:
- HTTP Request
- Встроенные методы и переменные
- Выражения
Пагинация в HTTP Request node
HTTP Request node поддерживает пагинацию для работы с API, которые возвращают данные по страницам. Здесь приведены основные способы настройки и примеры использования встроенных переменных.
Важные моменты при работе с API
Разные API реализуют пагинацию по-своему. Перед настройкой узла нужно уточнить в документации API:
- Предоставляет ли API URL следующей страницы?
- Есть ли ограничения на размер страницы или номер страницы?
- В какой структуре API возвращает данные?
Включение пагинации
- В HTTP Request node выберите Добавить опцию — Пагинация.
- Настройте нужный режим пагинации в зависимости от API.
Получение следующей страницы через URL из ответа
Если API возвращает URL следующей страницы в теле ответа:
- Установите Режим Пагинации — Ответ содержит следующий URL.
- В поле Следующий URL используйте выражение, которое извлекает URL из ответа.
Например, если API возвращает параметр “следующая страница” в теле ответа:
{{ $response.body[«next-page»] }}
Получение следующей страницы по номеру с $pageCount
Если API позволяет указывать конкретную страницу через номер:
- Установите Режим Пагинации — Обновление параметра в каждом запросе.
- Выберите Тип — Запрос.
- Введите имя параметра для страницы.
- Включите Выражение для поля Значение.
- Используйте выражение:
{{ $pageCount + 1 }}
$pageCount — это количество страниц, уже загруженных узлом. Начинается с 0. Добавление +1 позволяет начинать с первой страницы.
Пагинация через параметры тела запроса
Если API требует указывать номер страницы в теле POST-запроса:
- Метод запроса: POST
- Режим Пагинации — Обновление параметра в каждом запросе.
- Выберите Тело в параметре Тип.
- Введите имя параметра для страницы
- Включите Выражение и используйте:
{{ $pageCount + 1 }}
Установка размера страницы через запрос-параметр
Если API позволяет задавать размер страницы:
- В основных параметрах узла включите Отправить Параметры Запроса
- Введите имя параметра для размера страницы (например, limit)
- В поле Значение укажите нужный размер страницы, например: 50
Это определяет, сколько элементов будет возвращено на каждой странице.