Перейти к основному содержимому

Быстрый старт · первый запрос за три шага

Цель: собрать работающий HTTP-запрос с нуля. Когда вы поняли основную линию «Группа → Окружение → Запрос», любой другой протокол — это просто другой протокол и другой Pre-URL.


Шаг 1: создайте группу, привяжите окружение​

В Quick Request окружение привязывается к группе, и все запросы группы разделяют его.

  1. Создайте новую группу (например Моя первая группа).
  2. Привяжите окружение к группе. Если его еще нет, сначала создайте окружение (например Local).

Зачем лишний слой? Потому что при переходе модуля между dev / staging / production вы хотите править только окружение — а не десятки запросов.


Шаг 2: заполните Pre-URL в окружении​

Окружение хранит по одному базовому адресу на протокол. Чтобы отправить HTTP, заполните запись http:

Строка протоколаПример базового адресаПримечания
HTTPhttp://127.0.0.1:18080Используйте https:// для включения TLS
WebSocketws://127.0.0.1:18085Используйте wss:// для включения TLS
gRPCgrpc://127.0.0.1:18089Используйте grpcs:// для включения TLS
MQTTmqtt://127.0.0.1:18884Используйте mqtts:// для включения TLS

⚠️ Самая простая ловушка: к какому протоколу относится базовый адрес, решает схема в начале URL, а не то, в какую строку вы его ввели. Базовый адрес WebSocket должен записываться как ws://… или wss://…; если случайно ввести https://…, он будет обработан как HTTP, запрос WebSocket не найдет базовый адрес и упадет. Держите строку протокола и схему согласованными.

(Порты вроде 18080 выше взяты из примера тестового сервера; при тестировании своих API замените их реальными адресами.)


Шаг 3: создайте запрос, введите только фрагмент пути, отправьте​

Создайте запрос внутри группы:

  1. Протокол: HTTP; Метод: GET.
  2. URL — введите только фрагмент пути: /echo (не полный хост — хост уже предоставлен http Pre-URL окружения).
  3. Нажмите Отправить.

Вы увидите, что /echo возвращает ровно то, что вы отправили. По проводу на самом деле ушел http://127.0.0.1:18080/echo.


Получилось — что дальше?​

  • Хотите понять «почему только /echo» и «откуда берется {{x}}» → concepts
  • Хотите подписывать запросы перед отправкой / расшифровывать ответы → scripting
  • Хотите скопировать рецепт «вход за токеном, автоподстановка для всей группы» → recipes
  • Сменить протокол (WS/TCP/UDP/gRPC/MQTT) → соответствующая страница протокола (см. индекс)