본문으로 건너뛰기

퀵 스타트 · 3단계로 첫 요청 보내기

목표: 제로에서 동작하는 HTTP 요청을 조립합니다. '그룹 → 환경 → 요청'이라는 주 라인만 잡으면, 다른 프로토콜은 '다른 프로토콜 + 다른 Pre-URL'일 뿐입니다.


1단계: 그룹을 만들고 환경을 바인딩​

Quick Request에서는 환경이 그룹에 바인딩되고, 그룹 내 모든 요청이 공유합니다.

  1. 새 그룹을 만듭니다(예: 첫 번째 그룹).
  2. 그룹에 환경을 바인딩합니다. 아직 없다면 먼저 환경을 만듭니다(예: Local).

왜 이 한 층을 거칠까요? 모듈이 dev / staging / production을 이동할 때, 편집하고 싶은 것은 환경 하나이지 수십 개의 요청이 아니기 때문입니다.


2단계: 환경에 Pre-URL 입력​

환경은 프로토콜당 하나의 베이스 주소를 유지합니다. HTTP를 보내려면 http 라인을 입력합니다:

프로토콜 라인베이스 주소 예비고
HTTPhttp://127.0.0.1:18080https://로 TLS 활성화
WebSocketws://127.0.0.1:18085wss://로 TLS 활성화
gRPCgrpc://127.0.0.1:18089grpcs://로 TLS 활성화
MQTTmqtt://127.0.0.1:18884mqtts://로 TLS 활성화

⚠️ 가장 흔한 함정: 베이스 주소가 어느 프로토콜에 속하는지는 URL 앞부분의 scheme으로 결정되지, 입력한 라인으로 결정되지 않습니다. WebSocket 베이스 주소는 반드시 ws://… 또는 wss://…로 작성해야 합니다. 실수로 https://…를 입력하면 HTTP로 취급되어, WebSocket 요청은 베이스 주소를 찾지 못하고 실패합니다. 프로토콜 라인과 scheme을 일치시키세요.

(위의 18080 등 포트는 샘플 테스트 서버의 것입니다. 자신의 API를 시험할 때는 실제 주소로 교체하세요.)


3단계: 요청을 만들고 경로 조각만 입력해서 전송​

그룹 안에 요청을 만듭니다:

  1. 프로토콜: HTTP; 메서드: GET.
  2. URL — 경로 조각만 입력: /echo(완전한 호스트 불필요 — 호스트는 환경의 http Pre-URL이 이미 공급합니다).
  3. 전송을 탭합니다.

/echo가 보낸 내용을 그대로 돌려주는 것이 보입니다. 실제 와이어로 나간 것은 http://127.0.0.1:18080/echo입니다.


동작했다 — 다음은?​

  • '왜 /echo만으로 되는가', '{{x}}는 어디에서 오는가'를 이해하기 → concepts
  • 전송 전에 서명 / 응답 복호화하기 → 스크립트
  • '로그인으로 토큰 획득, 그룹 전체 자동 부착' 레시피 복사하기 → recipes
  • 프로토콜 바꾸기(WS/TCP/UDP/gRPC/MQTT) → 대응하는 프로토콜 페이지(인덱스 참조)