변수 사용하기

Apidog에서 변수를 사용하면 값을 쉽게 저장하고 재사용할 수 있습니다. 값을 변수로 저장하면 다양한 환경, 요청, 스크립트 및 테스트 시나리오에서 해당 값에 접근할 수 있습니다. 변수를 활용하면 생산성이 향상되고 동료 간 협업이 촉진됩니다.

변수란 무엇입니까?

변수는 데이터의 상징적 표현으로, 필요할 때마다 값을 수동으로 입력하지 않고도 값을 가져올 수 있게 해 줍니다. 이는 여러 위치에서 동일한 값을 재사용할 때 유용합니다.

예시:
여러 요청에서 동일한 토큰을 사용하고 있으며 변경 가능성이 있는 경우, 해당 토큰을 {{my_token}}이라는 변수로 저장하십시오. 요청 매개변수 값에 {{my_token}}을 사용하십시오. 토큰이 변경되면 변수 값을 업데이트하는 것만으로 모든 위치에 변경 사항이 반영됩니다.

변수는 매개변수 값, 본문, URL 또는 헤더에서 적용될 수 있습니다.

Apidog의 Tests 모듈에서는 변수를 사용하여 요청 간 데이터를 전달할 수 있습니다.

변수 범위

Apidog는 다양한 개발, 테스트 및 협업 요구 사항에 맞게 여러 범위의 변수를 지원합니다.

우선순위(낮은 순서에서 높은 순서): Global < Module < Environment < Data < Local

동일한 이름의 변수가 서로 다른 범위에 정의되어 있는 경우, 가장 좁은 범위의 값이 우선 적용됩니다.

전역 변수

프로젝트 내 공유: 전체 프로젝트에서 접근할 수 있습니다. 엔드포인트 간 데이터 공유(예: 로그인 토큰)에 유용합니다.

팀 내 공유: 여러 프로젝트에 걸쳐 전체 팀에서 공유됩니다(예: 로그인 프로젝트와 재무 프로젝트 간에 공유되는 토큰).

NOTE

권한: 팀 변수를 관리하려면 팀 관리자 권한이 필요합니다. Team Resources > Variables로 이동하십시오.

스크립트: 스크립트에서 pm.globals.set을 사용하여 로컬 값을 업데이트할 수 있지만, 이름이나 공유 값은 변경할 수 없습니다.

모듈 변수

모듈 내에서 정의됩니다. Postman의 "Collection variables"에서 가져오면 모듈 변수에 매핑됩니다.

환경 변수

특정 환경(Development, Testing, Production)에 연결됩니다. 활성 환경의 변수만 유효합니다.

데이터 변수

Test Scenarios 또는 CLI의 외부 CSV 또는 JSON 파일에서 제공됩니다. 실행 후에는 값이 유지되지 않습니다.

로컬 변수

단일 요청 또는 테스트 시나리오 실행에 한정되는 임시 변수입니다. 완료되면 사라집니다.

TIP

Apidog의 변수는 문자열로 저장됩니다. 객체나 배열을 저장할 때는 JSON.stringify()를 사용하여 저장하고 JSON.parse()를 사용하여 가져오십시오.

공유 값 및 로컬 값

각 변수에는 두 가지 상태가 있습니다.

공유 값: Apidog 서버와 동기화되며 팀과 공유됩니다.

로컬 값: 브라우저 또는 클라이언트 캐시에 로컬로 저장됩니다. 공유되지 않습니다.

모범 사례:

민감한 데이터(토큰, 비밀번호)는 사용자의 컴퓨터에만 유지되도록 로컬 값을 사용하십시오.

로컬 값을 비워 두면 공유 값으로 대체되어 사용됩니다.

링크 아이콘 🔗을 클릭하여 로컬 값을 공유 값과 동기화하십시오.

WARNING

Apidog 캐시를 정리하면 로컬 값이 삭제됩니다.

장치를 전환할 때 로컬 값은 자동으로 이전되지 않습니다(Environment 내보내기/가져오기를 사용하십시오).

Apidog CLI에서 변수 사용하기

CLI에서 실행할 때는 기본적으로 공유 값이 사용되는 반면, 클라이언트는 로컬 값을 사용합니다. 이는 클라이언트 실행과 CLI 실행 간 불일치가 발생하는 일반적인 원인입니다.

TIP

Apidog CLI에 대해 자세히 알아보십시오.

변수 정의하기

1. 환경 관리(사전 설정)

전역 변수 및 환경 변수의 값은 수동으로 사전 설정할 수 있습니다.

Environment Management 아이콘 ≡을 클릭하십시오.

Global Variables 또는 특정 환경을 선택하십시오.

변수 이름, 공유 값 및 로컬 값을 추가하십시오.

Save를 클릭하십시오.

2. 변수 추출

코드를 작성하지 않고도 API 응답에서 값을 시각적으로 추출하여 변수에 저장할 수 있습니다.

Run 탭(Design Mode)에서 Post Processors로 이동하십시오.

Extract Variable을 선택하십시오.

추출 소스(JSON, XML, Header 등)와 JSONPath를 구성하십시오.

요청을 전송하여 실행하고 Console에서 확인하십시오.

TIP

Extract Variable에 대해 자세히 알아보십시오.

3. 스크립트

Pre/Post-processors에서 pm 객체를 사용하십시오.

set 구문:

객체/배열 저장:

TIP

Script Syntax에 대해 자세히 알아보십시오.

4. 데이터베이스 작업

데이터베이스에 연결하여 데이터를 가져오고 변수로 설정할 수 있습니다.

Post Processors에서 Database Operation을 추가하십시오.

데이터베이스 연결을 구성하십시오.

SQL 명령을 입력하십시오({{variable}} 지원).

Extract Result To Variable을 설정하십시오.

TIP

Database Operations에 대해 자세히 알아보십시오.

요청 매개변수

URL, 매개변수, 헤더 또는 본문에서 이중 중괄호 {{variable}}를 사용하십시오.

예시 URL:
http://127.0.0.1/pet/findByStatus?status={{CurrentStatus}}

예시 JSON 본문:

{
    "status": "{{CurrentStatus}}",
    "quantity": {{TotalPet}}
}

WARNING

문자열: 문자열 변수에는 변수 주위에 큰따옴표 ""를 추가하십시오(예: "{{name}}").

숫자/불리언: 따옴표를 추가하지 마십시오(예: {{count}}).

하위 요소 접근하기

변수에 JSON 객체/배열이 포함되어 있는 경우, JSONPath를 사용하여 점 표기법으로 속성에 접근할 수 있습니다.

{{user}}의 객체:

{ "id": 1, "name": "Jack" }

요청: {{user.name}}

스크립트: pm.variables.get("user.name")

{{users}}의 배열:

[ { "name": "Jack" } ]

요청: {{users[0].name}}

스크립트: pm.variables.get("users[0].name")

스크립트에서 변수 사용하기

스크립트에서는 {{}} 대신 pm.*.get()을 사용하십시오.

로깅:

출력을 확인하려면 Console 탭을 확인하십시오.

데이터 변수 사용하기

Test Scenarios에서 CSV/JSON 파일을 가져오면 "데이터 변수"가 생성됩니다. 이를 참조하려면 {{column_name}}을 사용하십시오. 파일의 각 행은 별도의 반복을 트리거합니다.

TIP

Data Driven Testing에 대해 자세히 알아보십시오.

FAQ

Q: 목에서 변수를 사용할 수 있습니까?

아니요. 변수는 요청이 전송될 때 해석됩니다. 목은 정적 정의이거나, 동일한 방식의 클라이언트 측 "전송" 컨텍스트 없이 목 서버에서 실행됩니다.

Q: 스크립트에서 기본 URL을 어떻게 가져옵니까?

pm.request.getBaseUrl()을 사용하십시오.

기본이 아닌 서버 엔드포인트에서는 부정확할 수 있으므로 pm.environment.get('BASE_URL') 사용은 피하십시오.

변수 사용하기

변수란 무엇입니까?#

변수 범위#

공유 값 및 로컬 값#

Apidog CLI에서 변수 사용하기#

변수 정의하기#

1. 환경 관리(사전 설정)#

2. 변수 추출#

3. 스크립트#

4. 데이터베이스 작업#