핵심 개념
이 4가지 설계만 잡으면, 이후의 프로토콜과 시나리오는 모두 쉽습니다:
- 3개 엔티티 모델: 그룹 / 환경 / 요청의 관계
- 환경 Pre-URL 설계: 요청이 상대 경로만 저장하는 이유
- 전송 어셈블 파이프라인: 한 번의 '전송'이 설정을 실제 요청으로 바꾸는 방식
- 변수 시스템:
{{variable}}은 어디에서 해석되고, 3개의 변수 레이어란
3개 엔티티 모델
환경이 요청마다가 아니라 그룹에 바인딩되는 이유는? 그룹은 보통 '하나의 배포 대상 안에서 한 모듈의 전체 API'를 나타냅니다. 그룹 단위 바인딩은 환경 전환이 그룹 전체를 한 번에 옮긴다는 뜻입니다 — 요청별 편집이 필요 없습니다. 단일 요청만 다른 환경이 필요하다면, 그 환경에 바인딩된 그룹에 넣으면 됩니다.
환경 Pre-URL 설계
이것이 가장 중요한 — 그리고 가장 오해받기 쉬운 — 설계입니다.
요청은 상대 경로만 저장, 환경은 베이스 주소를 저장
전통적인 도구에서는 모든 요청이 완전한 URL(https://api.example.com/v1/users)을 저장하므로, 테스트 환경으로의 전환이 도메인 일괄 치환을 의미합니다. 이 도구는 이를 뒤집습니다:
scheme이 프로토콜과 TLS를 결정합니다 (중요!)
Pre-URL은 프로토콜별로 저장되지만, 어느 항목이 실제로 대응하는 프로토콜은 URL 앞부분의 scheme으로 결정됩니다. scheme은 '어떤 프로토콜인가'와 '암호화 여부(TLS)'를 모두 표현합니다:
| 프로토콜 | 평문 scheme | 암호화 scheme |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ 자주 하는 실수: WebSocket 베이스 주소는
ws:///wss://로 작성해야 합니다.https://를 입력하면 HTTP로 취급되어, WebSocket 요청은 베이스 주소를 찾지 못하고 실패합니다. 프로토콜 라인과 scheme을 일치시키세요.
전송 어셈블 파이프라인
'전송'을 탭해도 소켓이 바로 날아가지 않습니다. 파이프라인은 '요청 + 그룹의 환경 + 변수'를 단계적으로 조립해 실제 요청으로 만들고, 네트워크 호출 전후에 액션 체인을 삽입합니다:
핵심:
- 액션 체인은 '스크립트 실행'이 켜져 있을 때만 동작합니다. 앱에서 전송을 탭하면 기본 실행되지만, 자동화 / MCP 전송은 명시적으로 켜야 합니다. 스크립트가 꺼져 있으면 전송 전에 주입될 토큰도 암호화도 수행되지 않습니다 — recipes의 '토큰 없음 → 401' 부정 검증이 이 동작을 보여주는 이유입니다.
- 전송 전 스크립트는 나가는 요청을, 응답 후 스크립트는 받은 응답을 재작성합니다. 둘 다 런타임 변수를 읽고 쓸 수 있습니다.
변수 시스템
스코프가 다른 3종류의 '변수'가 있습니다. 이 혼동이 초심자에게 가장 흔한 함정입니다.
{{name}}은 실제로 무엇을 해석할 수 있나?
| 어디에 쓰는가 | 환경 변수 | 런타임 변수 | 전형적 용도 |
|---|---|---|---|
{{name}}(URL / params / headers / body 내) | ✅ | ❌ | 환경 설정 참조, 동적 값 삽입 |
| 스크립트 내 변수 읽기 | ✅ | ✅ | 로그인 토큰의 요청 간 전달 등 |
기억법:
{{}}가 보는 것은 '설정계' 변수뿐. 스크립트는 3계층 모두 읽을 수 있습니다. 런타임 변수는 '런타임 칠판' — 거기에 쓸 수 있는 것은 스크립트뿐이고,{{}}는 결코 거기를 보지 않습니다.
{{authToken}}이 로그인 시 저장한 토큰을 읽지 못하는 이유는? 로그인 스크립트가 런타임 레이어에 저장한 것이고, {{}}는 그것을 해석하지 않기 때문입니다. 올바른 방법은, 그것을 읽어 헤더에 주입하는 전송 전 스크립트입니다 (recipes, 시나리오 1 참조).
동적 변수 {{$xxx}}
{{}} 안에는 내장 동적 변수 세트도 있으며, 매 평가 때마다 새로 생성되어 URL / params / headers / body에서 바로 사용할 수 있습니다:
| 변수 | 생성하는 것 |
|---|---|
{{$timestamp}} / {{$timestampMs}} | Unix 타임스탬프(초 / 밀리초) |
{{$isoTimestamp}} | ISO8601 UTC |
{{$uuid}} / {{$guid}} | UUID v4 |
{{$randomInt}} / {{$randomInt min,max}} | 랜덤 정수(기본 0..1000) |
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} 등 | 각종 랜덤 샘플 데이터 |
예: GET /echo?ts={{$timestamp}}&u={{$uuid}} — 실제로는 매 전송마다 ts/u가 새로운 실제 값으로 교체됩니다.
요약
- 요청은 경로 조각만 저장하고, 환경이 Pre-URL로 프로토콜별 베이스 주소를 공급하며, scheme이 프로토콜 + TLS를 결정합니다.
- 전송은 어셈블 파이프라인입니다: URL 결합 → 보간 → 트랜스포트 설정 → 전송 전 체인 → 네트워크 → 응답 후 체인.
- 변수는 3계층:
{{}}는 설정계 변수를 읽고, 스크립트는 3계층 모두 읽습니다. 토큰 전달은{{}}가 아닌 스크립트로 합니다.
다음: 스크립트 →