Быстрый старт · первый запрос за три шага
Цель: собрать работающий HTTP-запрос с нуля. Когда вы поняли основную линию «Группа → Окружение → Запрос», любой другой протокол — это просто другой протокол и другой Pre-URL.
Шаг 1: создайте группу, привяжите окружение
В Quick Request окружение привязывается к группе, и все запросы группы разделяют его.
- Создайте новую группу (например
Моя первая группа). - Привяжите окружение к группе. Если его еще нет, сначала создайте окружение (например
Local).
Зачем лишний слой? Потому что при переходе модуля между dev / staging / production вы хотите править только окружение — а не десятки запросов.
Шаг 2: заполните Pre-URL в окружении
Окружение хранит по одному базовому адресу на протокол. Чтобы отправить HTTP, заполните запись http:
| Строка протокола | Пример базового адреса | Примечания |
|---|---|---|
| HTTP | http://127.0.0.1:18080 | Используйте https:// для включения TLS |
| WebSocket | ws://127.0.0.1:18085 | Используйте wss:// для включения TLS |
| gRPC | grpc://127.0.0.1:18089 | Используйте grpcs:// для включения TLS |
| MQTT | mqtt://127.0.0.1:18884 | Используйте mqtts:// для включения TLS |
⚠️ Самая простая ловушка: к какому протоколу относится базовый адрес, решает схема в начале URL, а не то, в какую строку вы его ввели. Базовый адрес WebSocket должен записываться как
ws://…илиwss://…; если случайно ввестиhttps://…, он будет обработан как HTTP, запрос WebSocket не найдет базовый адрес и упадет. Держите строку протокола и схему согласованными.
(Порты вроде 18080 выше взяты из примера тестового сервера; при тестировании своих API замените их реальными адресами.)
Шаг 3: создайте запрос, введите только фрагмент пути, отправьте
Создайте запрос внутри группы:
- Протокол: HTTP; Метод:
GET. - URL — введите только фрагмент пути:
/echo(не полный хост — хост уже предоставленhttpPre-URL окружения). - Нажмите Отправить.
Вы увидите, что /echo возвращает ровно то, что вы отправили. По проводу на самом деле ушел http://127.0.0.1:18080/echo.
Получилось — что дальше?
- Хотите понять «почему только
/echo» и «откуда берется{{x}}» → concepts - Хотите подписывать запросы перед отправкой / расшифровывать ответы → scripting
- Хотите скопировать рецепт «вход за токеном, автоподстановка для всей г руппы» → recipes
- Сменить протокол (WS/TCP/UDP/gRPC/MQTT) → соответствующая страница протокола (см. индекс)