HTTP-запрос к любому API без программирования

HTTP-запрос в nana800 обращается к любому API без кода: вы вписываете адрес, метод, заголовки и тело, а ответ сервера уходит в следующие блоки схемы. Так подключается сервис, для которого нет готового блока, если у него есть API и документация. Один успешный запрос стоит 0,10 ₽, а баланс каждый месяц бесплатно пополняется до 350 ₽.

Собрать в конструкторе
  • Запуск блока: 0,10 ₽
  • Бесплатно каждый месяц: 350 ₽
  • Карта не нужна

Что можно сделать

  • Подключать сервисы без готового блока: отправлять запросы GET, POST, PUT, PATCH и DELETE на любой адрес в интернете
  • Передавать ключ доступа в заголовке, например Authorization со значением Bearer и ваш токен
  • Отправлять тело в JSON с данными из предыдущих блоков, заголовок Content-Type: application/json блок поставит сам
  • Получать ответ сервера уже разобранным: код ответа, тело как JSON или текст, заголовки
  • Скачивать файлы: если сервер вернул картинку, PDF или архив, блок сохранит файл и отдаст ссылку на него
  • Проверять сайт или API по расписанию и присылать предупреждение в Telegram, если сервер ответил ошибкой

Блоки в конструкторе

  • HTTP-запрос

    Действие · 0,10 ₽ за запуск

    Отправляет запрос на указанный адрес с выбранным методом, заголовками и телом. Возвращает success, код ответа status_code, тело body, заголовки и текст ошибки error_message. Ждёт ответ до 60 секунд, принимает ответ до 10 МБ.

Как настроить

  1. 1

    Найдите нужный запрос в документации сервиса

    Откройте документацию API сервиса и выпишите адрес запроса, метод и способ передачи ключа доступа. Чаще всего ключ передают в заголовке Authorization со словом Bearer перед ним.

  2. 2

    Добавьте блок запроса в схему

    В конструкторе создайте схему, поставьте триггер «button» для проверки и добавьте блок «request». Впишите полный адрес вместе с https:// и выберите HTTP-метод.

  3. 3

    Заполните заголовки и тело

    В «Заголовках» слева напишите название, справа значение, например Authorization и Bearer ваш_токен. Для POST, PUT и PATCH появится поле «Тело запроса»: впишите JSON и подставьте в него данные из триггера или предыдущих блоков.

  4. 4

    Включите схему и проверьте ответ

    Включите схему, нажмите кнопку триггера «button» и откройте результат блока. Если сервер ответил кодом 2xx, в success будет true, а ответ лежит в body. Если что-то не так, в error_message будет код и текст ошибки от сервера.

  5. 5

    Используйте ответ и оставьте схему включённой

    Подставьте поля из body в следующие блоки, а блоком «condition» отправьте схему по другой ветке, если запрос не прошёл. Замените кнопку на нужный триггер, например вебхук или таймер, и оставьте схему включённой. Пока она включена, она стоит 0,42 ₽ в час.

Готовые связки

  • HTTP-запрос + Telegram

    Проверяйте сайт или API по расписанию и получайте сообщение в Telegram, если он не отвечает или вернул ошибку. Без кода и своего сервера, бесплатный старт.

Шаблоны с этим сервисом

  • Погода в Telegram (Weather info)

    Бот сам присылает в Telegram температуру в вашем городе по расписанию, данные берутся из API Яндекс Погоды. Бесплатный баланс каждый месяц, карта не нужна.

  • Мониторинг сайта с уведомлением в Telegram

    Шаблон проверяет сайт по расписанию и пишет в Telegram, если он ответил ошибкой или не открылся. Без своего сервера и кода, бесплатный баланс каждый месяц.

Частые вопросы

Один успешный запрос стоит 0,10 ₽, запрос, на который сервер ответил ошибкой, не списывается. Включённая схема стоит 0,42 ₽ в час. Баланс каждый месяц бесплатно пополняется до 350 ₽, карта не нужна. Если схема включена круглосуточно весь месяц, большая часть этой суммы уходит на часы её работы.

В заголовках блока. Чаще всего это заголовок Authorization со значением Bearer и ваш токен, но точное название заголовка указано в документации сервиса. Некоторые сервисы принимают ключ прямо в адресе, после знака ?.

Нет. Запросы на внутренние адреса вроде localhost, 10.x.x.x и 192.168.x.x запрещены. Сервер должен быть доступен из интернета, а адрес начинаться с http:// или https://.

Схема пойдёт дальше, а в результате блока будут success = false, код ответа и текст ошибки. Ответа блок ждёт до 60 секунд. Запросы GET, PUT и DELETE блок сам повторяет до двух раз, если сервер ответил кодом 502, 503 или 504 или связь оборвалась.

До 10 МБ. Ответ в JSON сразу разбирается, и его поля можно подставлять в следующие блоки. Если сервер вернул файл, например картинку или PDF, блок сохранит его и вернёт ссылку в file_url.

Нет, но нужно прочитать документацию API сервиса: какой адрес, метод и заголовки он ждёт. Всё остальное заполняется полями в браузере, код и свой сервер не нужны.

Соберите первую схему бесплатно

Регистрация бесплатная, карта не нужна. Каждый месяц баланс бесплатно пополняется до 350 ₽, этого хватает примерно на 3 500 запусков простых блоков.

Собрать в конструкторе