1. 개요
Postman에서 변수를 사용하면 값을 저장하고 다른 API에서 필요에 따라 사용할 수 있습니다. 이러한 값을 컬렉션, 환경 또는 모든 요청에 전달하여 참조할 수 있습니다. 기본적으로 이러한 변수를 보다 효율적으로 사용하여 저장된 값에 쉽게 액세스할 수 있습니다. 또한 이러한 변수를 사용하여 Postman을 통해 여러 팀원과 협력하거나 동적 워크플로우 를 설정할 수 있습니다.
이 기사에서는 변수, 해당 유형 및 API에 변수를 삽입하는 방법에 대해 자세히 설명합니다.
2. 변수란 무엇입니까?
변수는 데이터 표현을 상징하며 필요할 때마다 수동으로 입력하지 않고도 값에 액세스할 수 있습니다. 여러 곳에서 동일한 값을 사용해야 할 때 유용할 수 있습니다. 일부 인스턴스에는 기본 URL, 토큰 및 경로 변수가 포함됩니다. 또한 변수를 변경하면 이러한 변수가 사용되는 모든 위치에서 자동으로 변경되므로 이를 사용하면 요청이 더 유연해집니다.
Postman에서 변수를 키-값 쌍으로 정의할 수 있습니다. 키는 이 키를 사용하여 해당 값에 직접 액세스할 수 있도록 하는 변수 이름을 정의합니다 .
또한 변수 그룹을 설정하기 위해 환경을 사용할 수도 있습니다. 이러한 변수는 환경에 따라 다른 값을 갖습니다.
변수에 대해 자세히 알아보고 다양한 변수 범위를 이해해 봅시다.
2.1. 변수 범위
다양한 환경에서 값이 다른 API 개발 및 테스트를 처리할 수 있는 여러 범위가 있습니다. 다음은 가장 넓은 영역에서 가장 좁은 영역까지 정의된 변수 범위입니다.
- 전역 변수: 작업 공간 전체에서 액세스할 수 있으며 Postman에서 가장 넓은 범위를 갖습니다 . 작업 공간 내의 여러 요청 및 컬렉션 중 어디에서나 사용할 수 있습니다.
- 컬렉션 변수: 이러한 변수는 특정 컬렉션 내에서만 액세스할 수 있습니다 . 컬렉션 내의 모든 요청에서 사용할 수 있습니다. 또한 선택한 환경에 따라 변경되지 않습니다.
- 환경 변수: 이 변수를 사용하면 다양한 환경에 따라 작업 범위를 지정할 수 있습니다 . 로컬 환경, 스테이징 또는 프로덕션 환경과 같이 작업 중인 환경의 변화에 따라 변경됩니다.
- 데이터 변수: 이러한 유형의 변수는 외부에 있으며 Collection Runner로 수집을 실행하는 동안 데이터 세트를 정의합니다. CSV 또는 JSON 파일에서 추출할 수 있습니다. 요청 또는 컬렉션이 실행된 후 지속되지 않는 현재 값이 있습니다.
- 로컬 변수: 이러한 변수는 요청 스크립트를 통해서만 액세스할 수 있는 임시 변수 라고도 합니다. 현재 요청 또는 컬렉션까지만 범위가 있습니다. 실행이 완료되면 더 이상 사용할 수 없습니다.
2.2. 변수 유형
전역 및 환경 변수는 유형에 따라 추가로 분류할 수 있습니다. 구성 방법은 다음과 같습니다.
- 기본 유형: 변수는 기본적으로 이러한 유형입니다. 추가 속성이 없는 일반 텍스트로 표시됩니다.
- 비밀 유형: 이 변수는 암호와 유사하게 모든 작업 공간의 초기 값과 현재 값을 숨깁니다. 민감한 데이터의 의도하지 않은 공개를 방지할 수 있습니다.
3. 범위로 변수 정의
위에서 설명한 대로 변수를 여러 유형과 범위로 정의할 수 있습니다. 요청 작성기의 모든 범위에서 변수를 정의할 수 있습니다.
먼저 텍스트를 선택하고 변수로 설정을 클릭합니다 . 완료되면 새 변수로 저장해야 합니다. 그런 다음 값에 대한 키를 입력하고 Postman에서 사용할 수 있는 다양한 범위에서 선택합니다.
3.1. Response body을 변수로 설정
요청 Response body의 값을 변수로 설정 하고 컬렉션에서 추가로 사용할 수도 있습니다. 이는 여러 요청을 순서대로 실행하고 특정 흐름을 생성하는 데 도움이 됩니다.
먼저 저장하려는 텍스트를 선택하고 마우스 오른쪽 버튼을 클릭 하거나 Control-클릭 버튼을 눌러 변수로 저장합니다.
완료되면 가능한 옵션(예: 환경, 로컬 또는 전역)에서 관련 범위를 선택하고 변수 이름을 지정하여 저장해야 합니다.
3.2. 전역 변수 정의
Postman에서 전역 변수를 설정하는 단계를 살펴보겠습니다.
- 전역 변수 섹션에서 새 변수 추가 를 클릭한 다음 변수 이름을 입력하여 직접 전역 변수로 저장합니다.
- 또 다른 옵션은 유형으로 전역 옵션을 선택하여 값을 선택하고 변수를 저장하는 것입니다.
- 완료되면 저장을 표시하고 변경 사항을 확인하는 것을 잊지 마십시오.
다음 단계를 통해 전역 변수를 다운로드하고 다른 사람과 공유할 수도 있습니다.
- 먼저 Postman으로 이동하여 사이드바에서 환경 유형을 전역으로 선택합니다.
- 그런 다음 내보내기 버튼을 클릭하면 변수를 파일로 내보낼 수 있습니다.
- 준비가 되면 시스템에서 저장 을 클릭하고 필요에 따라 공유 하여 파일을 저장할 수 있습니다 .
3.3. 환경 변수 정의
다음 단계를 통해 Postman에 환경 변수를 저장할 수 있습니다.
- 먼저 새 변수 추가 를 클릭 하고 변수 이름을 입력합니다.
- 변수를 저장하기 전에 변수 유형을 환경으로 선택할 수 있습니다.
- 변수에는 초기 값과 현재 값을 지정해야 합니다.
- 완료되면 저장을 클릭하여 변경 사항을 확인해야 합니다.
3.4. 컬렉션 변수 정의
Postman은 또한 컬렉션 변수를 추가하고 필요에 따라 사용할 수 있는 기회를 제공합니다.
사이드바 에서 컬렉션 을 클릭하고 선택 해야 합니다. 완료되면 변수 탭을 선택하여 컬렉션 변수를 저장해 보겠습니다.
3.5 스크립트에서 변수 정의
컬렉션, 환경 또는 전역에서 변수를 정의하는 것과 유사하게 요청 스크립트에서 프로그래밍 방식으로 변수를 설정할 수도 있습니다.
이 모든 메서드는 ( variable_key , variable_value )를 입력으로 받습니다.
- pm.globals : 이 메소드는 요청 스크립트에서 전역 변수를 정의하는 데 사용됩니다 . 예: pm.globals.set("variable_key", "variable_value");
- pm.collectionVariables : 이 메서드를 사용하여 범위가 '컬렉션'인 변수를 정의할 수 있습니다 . 예: pm.collectionVariables.set("variable_key", "variable_value");
- pm.environment : 범위가 현재 환경인 환경 변수 를 정의하는 데 사용할 수 있습니다 . 예: pm.environment.set("variable_key", "variable_value");
- pm.variables : 로컬/임시 범위를 가진 로컬 변수를 정의합니다 . 예: pm.variables.set("variable_key", "variable_value");
- unset : 이 방법은 설정된 변수를 제거하는 데 사용할 수 있습니다 . unset은 범위에 따라 위의 변수 인스턴스로 정의할 수 있습니다. 예: pm.environment.unset("variable_key", "variable_value");
3.6 스크립트에서 변수 사용
위의 방법을 사용하여 변수를 스크립트에 저장했습니다. 따라서 다음 방법을 사용하여 현재 값을 검색할 수 있습니다.
- pm.variables.get("variable_key") : 로컬을 포함한 모든 범위의 변수에 액세스합니다.
- pm.globals.get("variable_key") : 전역 변수에 액세스할 수 있습니다.
- pm.collectionVariables.get("variable_key") : 컬렉션 변수에 접근할 수 있습니다.
- pm.environment.get("variable_key") : 환경 변수에 접근할 수 있습니다.
여기에서 variable_key 를 사용하여 값을 검색할 수 있습니다 . 개체는 범위 수준을 나타내고 get() 메서드는 값을 검색합니다.
pm.variables.get () 메서드는 스크립트 기능에 실제로 영향을 주지 않고 변수 범위를 변경하는 옵션도 제공합니다. 현재 우선 순위가 가장 높은 변수를 반환합니다.
4. 변수 사용
이제 다양한 변수 범위를 정의하고 이를 Postman에 저장하는 방법을 배웠습니다. 요청 경로 및 본문에서 이러한 변수를 사용하는 방법을 살펴보겠습니다.
Postman 전체에서 변수를 참조하려면 변수 이름 주위에 이중 중괄호를 사용해야 합니다. 정의된 대로 다른 변수에서 값을 자동으로 가져옵니다. 이는 모든 Postman에서 표준이며 변수 유형 및 범위에 의존하지 않습니다.
{{studentName}}
또한 CURL을 실행하거나 요청을 적중하면 변수가 확인되고 현재 값으로 변수가 업데이트됩니다. 아래 요청 URL은 변수를 참조합니다.
http://localhost:8080/get?student_name={{studentName}}
studentName 이 "John" 이라고 가정 합니다. Postman은 변수에서 값을 검색하고 현재 저장된 값을 보냅니다. 따라서 Postman을 통해 위의 요청을 하면 자동으로 요청으로 변환됩니다.
http://localhost:8080/get?student_name=John
5. 결론
이 사용방법(예제)에서는 GUI 모드를 사용하여 기본 초기화에 Postman 변수를 사용했습니다 .
또한 유형과 범위에 대해 배웠습니다. 또한 URI, 요청 본문 및 헤더와 같이 초기화할 수 있는 다양한 위치를 살펴보았습니다. 분명히 이것은 동일한 값을 여러 번 초기화하지 않음으로써 시간과 공간을 절약할 수 있게 해줍니다.