[Postman] Global, Collection, Environment 공통 변수 생성 및 호출 방법

개발 Tip/기타

[Postman] Global, Collection, Environment 공통 변수 생성 및 호출 방법

adjh54 2025. 2. 9. 18:06

728x170

해당 글에서는 Postman 내에서 공통 변수를 생성하고 호출하는 방법에 대해 알아봅니다.

1) Postman에서 공통 변수 설정

💡 Postman에서 공통 변수 설정

- 공통 변수를 설정하는 것은 API 테스트 작업을 더욱 효율적으로 만들어주는 중요한 기능입니다. 반복적으로 사용되는 값들을 한 곳에서 관리할 수 있습니다.
- 환경(개발, 테스트, 운영)에 따라 다른 값을 쉽게 적용할 수 있습니다.
- API 엔드포인트, 인증 토큰 등을 효율적으로 관리할 수 있습니다.

1. 공통 변수 종류

변수 종류	범위	사용 시기	특징	우선순위
Environment Variables	선택된 환경	환경별로 다른 값이 필요한 경우	개발/테스트/운영 환경별 다른 값 설정 가능	1순위 (최상위)
Collection Variables	특정 컬렉션 내부	특정 API 컬렉션에서만 사용되는 값	컬렉션 단위로 격리된 변수 관리	2순위
Global Variables	워크스페이스 전체	모든 환경에서 공통으로 사용되는 값	가장 넓은 범위	3순위 (최하위)

2. 공통 변수 호출 방법

💡 공통 변수 호출 방법

- 공통 변수에서는 동일한 중괄호를 두 번 감싸는 형태( {{ 변수명 }} )로 공통 변수를 호출할 수 있습니다. 또한 중괄호를 입력하기만 해도 자동 완성으로 변수명을 불러올 수 있습니다.
- 이러한 공통 변수는 변수명은 대소문자를 구분합니다.
- 존재하지 않는 변수를 호출하면 빈 값으로 처리됩니다

사용 구분	예시
기본 구문	{{변수명}}
URL에서 사용	https://{{baseUrl}}/api/users
Headers에서 사용	Authorization: Bearer {{token}}
Request Body에서 사용	{"userId": "{{userId}}"}

2) 글로벌 변수(Global Variables)

💡 글로벌 변수(Global Variables)

- Postman 워크스페이스 전체에서 사용할 수 있는 전역 변수입니다. 모든 컬렉션과 요청에서 접근이 가능하며, 가장 넓은 범위의 변수입니다.

- 워크스페이스의 모든 컬렉션에서 접근 가능
- 일반적으로 모든 환경에서 동일하게 유지되어야 하는 값에 사용
- 다른 변수 유형보다 우선순위가 낮음

1. 상단 오른쪽에 아이콘을 선택합니다.

2. All variables > Globals > Add 버튼을 누릅니다.

3. 변수명(VARIABLE)과 값(INITIAL VALUE)을 입력하고 ‘Save’ 합니다.

4. 해당 부분을 수정해봅니다.

5. “{”를 입력하면 자동완성으로 생성이 되어 이를 선택합니다.

6. 글로벌 변수 값에 따라 호출이 잘 됨을 확인하였습니다.

3) 컬렉션 변수(Collection Variables)

💡 컬렉션 변수(Collection Variables)

- 특정 컬렉션 내에서만 사용할 수 있는 변수이며 해당 컬렉션에 속한 모든 요청에서 접근이 가능합니다.
- 컬렉션별로 독립적인 변수 관리가 가능합니다.
- Global Variables보다 우선순위가 높지만, Environment Variables보다는 낮습니다.

1. 아래와 같이 Workspace 내에 각각의 Collection들이 구성되어 있습니다.

2. 지정하려는 Collection에 더 보기(…) 버튼을 선택하고 Edit 버튼을 선택합니다.

3. Variables 탭을 선택합니다.

4. 아래와 같이 Variable, Initial value 값을 입력하고 저장하였습니다.

5. 아래와 같이 Collection 내에서 조회가 됨을 확인하였습니다.

6. 호출 역시 잘됨을 확인하였습니다.

4) 환경 변수(Environment Variables)

💡 환경 변수(Environment Variables)

- 특정 환경(개발, 테스트, 운영 등)에 따라 다른 값을 설정할 수 있는 변수입니다.
- 동일한 API를 다른 서버 환경에서 테스트할 때 유용합니다. 가장 높은 우선순위를 가지며, 동일한 이름의 Collection 또는 Global 변수보다 우선적으로 적용됩니다.
- 환경 전환이 쉽고 민감한 정보(API 키, 비밀번호 등)를 안전하게 관리할 수 있습니다.