Apidog 변수 시스템 완벽 마스터하기

API 개발과 테스트에서 변수는 토큰, 사용자 ID, 설정값 등을 반복 없이 재사용할 수 있게 해주는 핵심 기능입니다. Apidog는 다양한 시나리오에 맞는 6가지 변수 타입을 제공합니다.

6가지 변수 타입

1. 팀 레벨 글로벌 변수

팀 전체에서 공유되는 변수로, 모든 프로젝트에서 접근 가능합니다.

• 사용 사례: 회사 전체 API 키, 공통 인증 토큰

2. 프로젝트 레벨 글로벌 변수

특정 프로젝트 내에서만 사용되는 변수입니다.

• 사용 사례: 프로젝트별 설정값, 공통 엔드포인트

3. 모듈 변수

특정 모듈(폴더) 범위에서만 유효한 변수입니다.

• 사용 사례: 마이크로서비스별 설정, 기능 단위 설정

4. 환경 변수

개발, 테스트, 프로덕션 등 환경별로 다른 값을 가지는 변수입니다.

• 사용 사례: 서버 URL, 데이터베이스 연결 정보

5. 테스트 데이터 변수

CSV/JSON 파일에서 가져온 데이터로, 데이터 기반 테스트에 사용됩니다.

• 사용 사례: 대량 테스트, 다양한 입력값 테스트

6. 로컬 변수

임시적으로 사용되는 변수로, 가장 높은 우선순위를 가집니다.

• 사용 사례: 테스트 실행 중 임시 값, 디버깅용 오버라이드

변수 우선순위 체계

Apidog는 이름 충돌 시 다음 우선순위로 변수를 해결합니다:

로컬 변수 > 테스트 데이터 변수 > 환경 변수 > 모듈 변수 > 프로젝트 글로벌 변수 > 팀 글로벌 변수

Initial Value vs Current Value

글로벌, 모듈, 환경 변수는 두 가지 값을 유지합니다:

사용 팁: 개인 API 키 같은 민감한 정보는 Current Value에 저장하세요.

변수 설정 방법

방법 1: 직접 설정

Environment Management에서 직접 변수명과 값을 입력합니다.

방법 2: API 응답에서 추출

// JSONPath를 사용한 응답 값 추출
$.data.user.id → {{userId}}
$.data.token → {{authToken}}

방법 3: 스크립트 사용

// Pre/Post Processor에서 변수 설정
pm.environment.set("userId", response.data.id);
pm.globals.set("apiKey", "your-api-key");

방법 4: 데이터베이스 쿼리

데이터베이스에서 직접 조회한 값을 변수로 설정할 수 있습니다.

변수 사용 문법

변수는 이중 중괄호 표기법을 사용합니다:

URL: https://api.example.com/users/{{userId}}
Header: Authorization: Bearer {{authToken}}
Body: { "name": "{{userName}}" }

중첩 객체 접근

{{user.profile.name}}  // 점 표기법
{{users[0].id}}        // 배열 인덱싱

실무 활용 예제

환경별 자동 전환

개발 환경: BASE_URL = http://localhost:3000
테스트 환경: BASE_URL = https://test-api.example.com
프로덕션: BASE_URL = https://api.example.com

환경을 전환하면 모든 API 요청의 BASE_URL이 자동으로 변경됩니다.

결론

Apidog의 변수 시스템을 잘 활용하면 API 테스트의 효율성과 유지보수성이 크게 향상됩니다. 특히 팀 협업과 다중 환경 관리에서 강력한 효과를 발휘합니다.