Przejdź do głównej zawartości

Quick Start · Twoje pierwsze żądanie w trzech krokach

Cel: zbudować działające żądanie HTTP od zera. Gdy zrozumiesz główną linię „Grupa → Środowisko → Żądanie”, każdy inny protokół to tylko inny protokół i inny Pre-URL.


Krok 1: utwórz grupę, powiąż środowisko​

W Quick Request środowisko jest powiązane z grupą, i wszystkie żądania w grupie się nim współdzielą.

  1. Utwórz nową grupę (np. Moja pierwsza grupa).
  2. Powiąż środowisko z grupą. Jeśli jeszcze go nie masz, najpierw utwórz środowisko (np. Lokalne).

Po co ta dodatkowa warstwa? Bo gdy moduł przechodzi między dev / staging / produkcją, chcesz edytować tylko środowisko — a nie dziesiątki żądań.


Krok 2: wpisz Pre-URL w środowisku​

Środowisko przechowuje jeden adres bazowy na protokół. Aby wysyłać HTTP, wypełnij wpis http:

Linia protokołuPrzykładowy adres bazowyUwagi
HTTPhttp://127.0.0.1:18080Użyj https://, aby włączyć TLS
WebSocketws://127.0.0.1:18085Użyj wss://, aby włączyć TLS
gRPCgrpc://127.0.0.1:18089Użyj grpcs://, aby włączyć TLS
MQTTmqtt://127.0.0.1:18884Użyj mqtts://, aby włączyć TLS

⚠️ Najłatwiejsza pułapka: do którego protokołu należy adres bazowy, decyduje schemat na początku URL, a nie to, do której linii go wpisałeś. Adres bazowy WebSocket musi być zapisany jako ws://… lub wss://…; jeśli omyłkowo wpiszesz https://…, zostanie potraktowany jako HTTP, żądanie WebSocket nie znajdzie adresu bazowego i się nie powiedzie. Trzymaj linię protokołu i schemat w zgodzie.

(Porty takie jak 18080 powyżej pochodzą z przykładowego serwera testowego; przy testowaniu własnych API podstaw swoje prawdziwe adresy.)


Krok 3: utwórz żądanie, wpisz tylko fragment ścieżki, wyślij​

Utwórz żądanie w grupie:

  1. Protokół: HTTP; Metoda: GET.
  2. URL — wpisz tylko fragment ścieżki: /echo (nie pełny host — host jest już dostarczany przez Pre-URL http środowiska).
  3. Naciśnij Wyślij.

Zobaczysz, że /echo odsyła dokładnie to, co wysłałeś. Po drucie faktycznie poszło http://127.0.0.1:18080/echo.


Działa — co dalej?​

  • Chcesz zrozumieć „dlaczego tylko /echo” i „skąd bierze się {{x}}” → concepts
  • Chcesz podpisywać żądania przed wysłaniem / deszyfrować odpowiedzi → scripting
  • Chcesz skopiować przepis „logowanie po token, automatyczne dołączanie dla całej grupy” → recipes
  • Zmiana protokołu (WS/TCP/UDP/gRPC/MQTT) → pasująca strona protokołu (zobacz index)