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

해당 글에서는 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 키, 비밀번호 등)를 안전하게 관리할 수 있습니다.

 

1. Environments 탭 > + 버튼을 눌러서 환경을 구분 짓습니다.

---

 

2. 이름을 지정하고 변수와 초기 값을 입력합니다.

---

 
 

3. 비교를 위해 새로운 환경을 만들고 이름을 지정, 변수와 초기값을 입력합니다.

---

 
 

4. 우선 ‘LOCAL’ 환경을 선택하였습니다.

---

 
 

5. 변수를 호출하였을 때 Scope가 Environment 값으로 선택되어 LOCAL의 값이 선택되었습니다.

---

 
 
 

6. ‘PRD’ 환경을 선택하였습니다.

---

 
 

7. 변수를 호출하였을때 Scope가 Environment 값으로 선택되어 PRD의 값이 선택되었습니다.

---

 
 
 

오늘도 감사합니다 😀