본문으로 건너뛰기

핵심 개념

이 4가지 설계만 잡으면, 이후의 프로토콜과 시나리오는 모두 쉽습니다:

  1. 3개 엔티티 모델: 그룹 / 환경 / 요청의 관계
  2. 환경 Pre-URL 설계: 요청이 상대 경로만 저장하는 이유
  3. 전송 어셈블 파이프라인: 한 번의 '전송'이 설정을 실제 요청으로 바꾸는 방식
  4. 변수 시스템: {{variable}}은 어디에서 해석되고, 3개의 변수 레이어란

3개 엔티티 모델​

환경이 요청마다가 아니라 그룹에 바인딩되는 이유는? 그룹은 보통 '하나의 배포 대상 안에서 한 모듈의 전체 API'를 나타냅니다. 그룹 단위 바인딩은 환경 전환이 그룹 전체를 한 번에 옮긴다는 뜻입니다 — 요청별 편집이 필요 없습니다. 단일 요청만 다른 환경이 필요하다면, 그 환경에 바인딩된 그룹에 넣으면 됩니다.


환경 Pre-URL 설계​

이것이 가장 중요한 — 그리고 가장 오해받기 쉬운 — 설계입니다.

요청은 상대 경로만 저장, 환경은 베이스 주소를 저장​

전통적인 도구에서는 모든 요청이 완전한 URL(https://api.example.com/v1/users)을 저장하므로, 테스트 환경으로의 전환이 도메인 일괄 치환을 의미합니다. 이 도구는 이를 뒤집습니다:

scheme이 프로토콜과 TLS를 결정합니다 (중요!)​

Pre-URL은 프로토콜별로 저장되지만, 어느 항목이 실제로 대응하는 프로토콜은 URL 앞부분의 scheme으로 결정됩니다. scheme은 '어떤 프로토콜인가'와 '암호화 여부(TLS)'를 모두 표현합니다:

프로토콜평문 scheme암호화 scheme
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://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계층 모두 읽습니다. 토큰 전달은 {{}}가 아닌 스크립트로 합니다.

다음: 스크립트 →