퀵 스타트 · 3단계로 첫 요청 보내기
목표: 제로에서 동작하는 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 앞부분의 scheme으로 결정되지, 입력한 라인으로 결정되지 않습니다. WebSocket 베이스 주소는 반드시
ws://…또는wss://…로 작성해야 합니다. 실수로https://…를 입력하면 HTTP로 취급되어, WebSocket 요청은 베이스 주소를 찾지 못하고 실패합니다. 프로토콜 라인과 scheme을 일치시키세요.
(위의 18080 등 포트는 샘플 테스트 서버의 것입니다. 자신의 API를 시험할 때는 실제 주소로 교체하세요.)
3단계: 요청을 만들고 경로 조각만 입력해서 전송
그룹 안에 요청을 만듭니다:
- 프로토콜: HTTP; 메서드:
GET. - URL — 경로 조각만 입력:
/echo(완전한 호스트 불필요 — 호스트는 환경의httpPre-URL이 이미 공급합니다). - 전송을 탭합니다.
/echo가 보낸 내용을 그대로 돌려주는 것이 보입니다. 실제 와이어로 나간 것은 http://127.0.0.1:18080/echo입니다.