Apidog Docs
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 테스트 시나리오
  • Apidog 학습 센터
  • 시작하기
    • Apidog 소개
    • Apidog의 기본 개념
    • Apidog 탐색하기
    • 빠른 시작
      • 개요
      • 엔드포인트 생성하기
      • 요청 만들기
      • 어서션 추가하기
      • 테스트 시나리오 생성
      • API 문서 공유
      • 더 알아보기
    • Apidog로 마이그레이션
      • 개요
      • 수동 가져오기
      • 예약 가져오기(데이터 소스 바인딩)
      • 가져오기 옵션
      • 데이터 내보내기
      • 가져오기
        • Postman에서 가져오기
        • OpenAPI Spec 가져오기
        • cURL 가져오기
        • Markdown 가져오기
        • Insomnia에서 가져오기
        • apiDoc에서 가져오기
        • .har 파일 가져오기
        • WSDL 가져오기
  • Mock API 데이터
    • 개요
    • 스마트 목
    • 사용자 지정 목
    • 목 우선순위 순서
    • 목 스크립트
    • 클라우드 목
    • Self-Hosted Runner Mock
    • 목 언어(로케일)
  • 계정 및 환경설정
    • 계정 설정
    • OpenAPI 액세스 토큰 생성
    • 알림
    • 언어 설정
    • 단축키
    • 네트워크 프록시 구성
    • 데이터 백업
    • Apidog 업데이트
    • 계정 삭제
    • 실험적 기능
  • 요청 보내기
    • 개요
    • SSE 디버깅
    • MCP 클라이언트
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP 또는 WebService
    • GraphQL
    • gRPC
    • 디버깅에 요청 프록시 에이전트 사용
    • 요청 만들기
      • 요청 기록
      • 요청 기본 사항
      • 매개변수 및 본문
      • 요청 헤더
      • 요청 설정
      • 요청 디버그
      • 요청을 엔드포인트로 저장하기
      • HTTP/2
    • 인증 및 권한 부여
      • 개요
      • CA 및 클라이언트 인증서
      • 인증 유형
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 인증
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • 응답 및 쿠키
      • API 응답 보기
      • 쿠키 관리
      • 개요
  • API 개발 및 디버깅
    • 개요
    • 요청 생성
    • 요청 보내기
    • 디버깅 케이스
    • 테스트 케이스
    • 동적 값
    • 응답 검증
    • 디자인 우선 vs 요청 우선
    • 코드 생성
    • 환경 및 변수
      • 개요
      • 변수 사용하기
      • 환경 관리
    • Vault 시크릿
      • 개요
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 동적 값 모듈
      • Airline
      • 동물
      • 색상
      • Commerce
      • Company
      • 데이터베이스
      • Datatype
      • 날짜
      • 금융
      • Food
      • Git
      • Hacker
      • Helpers
      • Image
      • Internet
      • Location
      • Lorem
      • 음악
      • Number
      • Person
      • Phone
      • 과학
      • String
      • System
      • Vehicle
      • Word
    • 사전/사후 프로세서
      • 개요
      • 어서션
      • 변수 추출
      • Wait
      • 보안
      • 데이터베이스 작업
        • 개요
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • 스크립트 사용
        • 개요
        • 전처리 스크립트
        • 사후 처리 스크립트
        • Public Scripts
        • Postman 스크립트 참조
        • 다른 프로그래밍 언어 호출하기
        • JS 라이브러리 사용하기
        • 응답 시각화
        • 스크립트 예제
          • 어서션 스크립트
          • 변수 사용하기
          • 요청 수정하기
          • 기타 예시
    • API 디버깅
      • AI Agent Debugger
      • A2A Debugger
  • API 설계
    • 개요
    • 새 API 프로젝트 생성
    • 엔드포인트 기본 사항
    • API 설계 지침
    • 모듈
    • 여러 요청 본문 예시 구성
    • 컴포넌트
    • 공통 필드
    • 전역 매개변수
    • 엔드포인트 변경 이력
    • 댓글
    • 엔드포인트 일괄 관리
    • 사용자 지정 프로토콜 API
    • Spec-first 모드(Beta)
    • 보안 스키마
      • 개요
      • 보안 스키마 생성
      • 보안 스키마 사용
      • 온라인 문서의 보안 스키마
    • 고급 기능
      • 사용자 지정 엔드포인트 필드
      • 연결된 테스트 시나리오
      • 엔드포인트 상태
      • 매개변수 목록의 표시 방식
      • 엔드포인트 고유 식별
    • 스키마
      • 개요
      • 새 스키마 생성
      • 스키마 구축
      • JSON 등에서 스키마 생성
      • oneOf, allOf, anyOf
      • Discriminator 사용하기
  • API 테스트
    • 개요
    • 테스트 시나리오
      • 테스트 시나리오 생성
      • 요청 간 데이터 전달
      • 흐름 제어 조건
      • 엔드포인트 및 엔드포인트 케이스에서 데이터 동기화
      • 다른 프로젝트에서 엔드포인트 및 엔드포인트 케이스 가져오기
      • 테스트 시나리오 내보내기
    • 테스트 보고서
      • 테스트 보고서
    • 테스트 시나리오 실행
      • 테스트 시나리오 실행
      • 테스트 시나리오 일괄 실행
      • 데이터 기반 테스트
      • 공유 테스트 데이터
      • 예약 작업
      • 다른 프로젝트의 API 런타임 환경 관리
    • 테스트 스위트
      • 개요
      • 테스트 스위트 생성
      • 테스트 스위트 오케스트레이션
      • 로컬에서 테스트 스위트 실행
      • CLI를 통해 테스트 스위트 실행
      • 예약 작업
    • API 테스트
      • 통합 테스트
      • 성능 테스트
      • 엔드투엔드 테스트
      • 회귀 테스트
      • 계약 테스트
    • Apidog CLI
      • 개요
      • Apidog CLI 설치 및 실행
      • Apidog CLI 옵션
    • CI/CD
      • 개요
      • Github Actions와 통합
      • Gitlab과 통합
      • Jenkins와 통합하기
      • Git 커밋으로 테스트 트리거하기
  • API 문서 게시
    • 개요
    • 지원되는 API 기술
    • Quick Share
    • API 문서 보기
    • Markdown 문서
    • 문서 사이트 게시
    • 사용자 지정 로그인 페이지
    • 사용자 지정 레이아웃
    • 사용자 지정 CSS, JavaScript, HTML
    • 사용자 지정 도메인
    • AI 기능
    • SEO 설정
    • 고급 설정
      • 문서 검색
      • CORS 프록시
      • Google Analytics 통합
      • 폴더 트리 설정
      • 가시성 설정
      • 문서 URL에 값 임베드하기
    • API 버전
      • 개요
      • API 버전 생성
      • API 버전 게시
      • API 버전별 엔드포인트 공유
  • 브랜치
    • 개요
    • 스프린트 브랜치 생성
    • 브랜치에서 API 테스트하기
    • 브랜치에서 API 설계하기
    • 스프린트 브랜치 병합
    • 스프린트 브랜치 관리
    • AI Branch(베타)
  • AI 기능
    • 개요
    • AI 기능 활성화
    • 테스트 케이스 생성
    • AI로 스키마 수정하기
    • 엔드포인트 규정 준수 검사
    • API 문서 완성도 검사
    • AI 기반 필드 명명
    • 자주 묻는 질문
  • Apidog MCP 서버
    • 개요
    • AI에 Apidog 프로젝트 연결
    • 게시된 문서를 AI에 연결하기
    • OpenAPI 파일을 AI에 연결하기
  • 모범 사례
    • API 서명 처리
    • OAuth 2.0으로 보호되는 API에 접근하기
    • 협업 워크플로
    • 인증 상태 관리
  • 오프라인 공간
    • 개요
  • Apidog Europe
    • Apidog Europe
  • 관리
    • 프로젝트 관리
      • 프로젝트 관리
      • 알림 설정
      • 프로젝트 멤버 관리
      • 프로젝트 리소스
        • 데이터베이스 연결
        • Git 연결
    • 팀 관리
      • 팀 관리
      • 팀 멤버 관리
      • 팀 활동
      • 팀 역할 및 권한
      • 팀 리소스
        • General Runner
        • 팀 변수
        • 요청 프록시 에이전트
      • 실시간 협업
        • 팀 협업
    • 온보딩 체크리스트
      • 기본 개념
      • 온보딩 가이드
    • 조직 관리
      • 조직 관리
      • 조직 역할 및 권한
      • 플랜 관리
        • 조직의 청구 관리자
      • Single Sign-On (SSO)
        • SSO 개요
        • Microsoft Entra ID 구성
        • Okta 구성하기
        • 조직에 대한 SSO 구성
        • 사용자 계정 관리
        • 그룹을 팀에 매핑하기
      • SCIM 프로비저닝
        • SCIM 프로비저닝 소개
        • Microsoft Entra ID
        • Okta
      • 조직 리소스
        • 셀프 호스팅 Runner
  • 청구
    • 개요
    • 크레딧
    • 플랜 업그레이드
    • 대체 결제 방법
    • 구독 관리
    • 유료 팀을 조직으로 이동하기
  • 애드온
    • API Hub
    • Apidog Intellij IDEA 플러그인
    • 브라우저 확장 프로그램
      • Chrome
      • Microsoft Edge
    • 요청 프록시
      • 웹에서의 요청 프록시
      • 공유 문서의 요청 프록시
      • 클라이언트의 요청 프록시
  • 데이터 및 보안
    • 데이터 저장 및 보안
    • 사용자 데이터 개인정보 보호 및 보안
    • 요청 라우팅 및 데이터 보안
  • 참조
    • API 설계 우선 접근 방식
    • Apidog OpenAPI 사양 확장
    • JSONPath
    • XPath
    • 정규 표현식
    • JSON Schema
    • CSV 파일 형식
    • Java 환경 설치
    • Runner 배포 환경
    • Apidog Markdown 구문
    • Apidog Swagger 확장
      • 개요
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema 확장
      • 개요
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • 지원 센터
  1. 테스트 시나리오

요청 간 데이터 전달

자동화 테스트 시나리오에서는 여러 요청 간에 데이터를 전달하는 일이 매우 일반적입니다. 대표적인 사례는 다음과 같습니다.
요청 1은 토큰을 반환하는 로그인 요청이며, 요청 2는 이 토큰을 사용하여 다른 데이터를 요청합니다.
요청 1은 ID를 반환하며, 요청 2는 이 ID를 기반으로 작업을 수행합니다.
요청 1은 목록을 반환하며, 요청 2는 이 목록의 데이터를 사용합니다.
이러한 시나리오를 위해 Apidog는 요청 간 데이터 전달을 처리하는 두 가지 솔루션을 제공합니다. 현재 해결하려는 구체적인 문제에 따라 적절한 솔루션을 선택하실 수 있습니다.
방법장점제한 사항사용 가능 범위
이전 단계 데이터 가져오기간단하며, 추가 변수가 필요하지 않습니다데이터를 여러 번 참조해야 할 때 다소 번거롭습니다Tests 모듈에서만 사용 가능
변수 사용여러 번 참조하기에 편리합니다단일 참조의 경우 다소 더 복잡합니다Tests 및 APIs 모듈

이전 단계 데이터 가져오기#

요청 1이 토큰을 반환하는 로그인 요청이고, 요청 2가 이 토큰을 사용하여 추가 데이터를 요청하는 시나리오를 살펴보겠습니다.
1
로그인 요청(요청 1)을 테스트 시나리오에 추가합니다.
2
조회 요청(요청 2)을 테스트 시나리오에 추가합니다.
3
요청 2의 쿼리 매개변수에는 요청 1에서 반환된 토큰이 포함되어야 합니다. 요청 2의 쿼리 매개변수에서 토큰 필드의 "magic wand" 아이콘 🪄을 클릭하고 "이전 단계 데이터 가져오기"를 선택합니다.
4
데이터를 가져올 대상으로 요청 1을 선택하고, 응답 본문을 선택한 다음, JSONPath를 사용하여 요청 1에서 반환된 토큰을 추출합니다. 예: $.token.
5
Insert를 클릭하면 {{$.2.response.body.token}}이 쿼리 매개변수로 삽입된 것을 확인할 수 있습니다.
6
테스트 시나리오에서 "Run" 버튼을 클릭하면 요청 1의 데이터를 요청 2로 성공적으로 전달할 수 있습니다.
"이전 단계 데이터 가져오기" 기능은 "Tests" 모듈에서만 사용할 수 있으며, "APIs" 모듈에서는 사용할 수 없습니다.
"이전 단계 데이터 가져오기"를 사용할 때는 전체 테스트 시나리오를 함께 실행해야만 값을 가져올 수 있으며, 개별 단계를 실행할 때는 접근할 수 없습니다.

변수 구문을 사용하여 이전 단계 데이터 참조하기#

이전 내용의 {{$.2.response.body.token}} 예시를 사용하면 다음과 같습니다.
'2'는 단계 ID를 나타내며, 각 테스트 단계에서 확인할 수 있습니다.
'response.body'는 이전 단계 데이터의 위치를 나타냅니다. 여기에는 요청의 헤더, 본문 또는 응답의 헤더나 본문 등의 데이터가 포함될 수 있습니다. 자세한 내용은 아래를 참조하십시오.
'token'은 본문 내 다음 레벨에 있는 'token' 데이터를 나타냅니다. JSONPath 구문을 사용하여 원하는 데이터를 추출할 수 있습니다.
이전 단계 데이터는 요청 매개변수, 헤더, 인증 등 요청의 다양한 부분에서 활용할 수 있습니다. 또한 아래와 같이 요청 본문에 데이터를 직접 삽입할 수도 있습니다.
스크립트에서 이전 단계 데이터를 사용해야 하는 경우, {{variable}} 구문으로 변수를 직접 참조할 수 없다는 점에 유의해야 합니다. 대신 pm.variables.get을 사용하여 이전 단계 데이터를 참조해야 합니다. 예:

구문 참조#

범주기능구문 예시
요청URL{{$.<step id>.request.url}}
경로 매개변수{{$.<step id>.request.pathParam.<field name>}}
쿼리{{$.<step id>.request.query.<field name>}}
헤더{{$.<step id>.request.header.<field name>}}
본문(form){{$.<step id>.request.body.<field name>}}
본문(json){{$.<step id>.request.body.<field path>}}
응답본문{{$.<step id>.response.body.<field path>}}
헤더{{$.<step id>.response.header.<field name>}}
쿠키{{$.<step id>.response.cookie.<field name>}}
루프요소(ForEach 루프의 배열 요소){{$.<loop step id>.element.<field path>}}
인덱스{{$.<loop step id>.index}}

변수를 사용하여 데이터 전달하기#

요청 1이 토큰을 반환하는 로그인 요청이고, 요청 2가 이 토큰을 사용하여 추가 데이터를 요청하는 시나리오를 살펴보겠습니다.
1
로그인 요청(요청 1)을 테스트 시나리오에 추가합니다.
2
요청 1의 후처리기에서 "변수 추출" 작업을 추가하여 $.token을 {{token}}으로 추출합니다.
변수 추출에 대해 자세히 알아보십시오.
3
조회 요청(요청 2)을 테스트 시나리오에 추가합니다.
4
요청 2의 쿼리 매개변수에서 변수 {{token}}을 참조합니다.
5
테스트 시나리오에서 "Run" 버튼을 클릭하면 요청 1의 데이터를 요청 2로 성공적으로 전달할 수 있습니다.

FAQ#

Q: 이전 단계 데이터를 성공적으로 참조할 수 없는 이유는 무엇입니까?
A: 먼저 현재 "Tests" 모듈에 있는지 확인하십시오. "이전 단계 데이터 참조" 기능은 Tests 모듈에서만 사용할 수 있으며 APIs 모듈에서는 사용할 수 없습니다.
현재 Tests 모듈에 있는 것이 확실하다면, "Actual Request" 탭으로 전환하여 요청에서 참조한 이전 단계 데이터가 성공적으로 반영되었는지 확인하십시오.
실제 요청의 참조가 실제 데이터를 표시하는 대신 여전히 {{$.n.response.body.abc}}로 표시된다면, 해당 참조가 적용되지 않았음을 의미합니다.
이 경우 다음과 같은 일반적인 원인을 고려해 보십시오.
1.
단일 단계만 실행한 것이 아니라 전체 테스트 시나리오를 실행하셨습니까? 이전 단계 데이터 참조가 적용되려면 전체 테스트 시나리오를 실행해야 합니다.
2.
단계 ID가 올바르며 참조하려는 단계에 해당하는지 확인하십시오.
3.
사용한 JSONPath가 데이터 소스와 정확히 일치하는지 확인하십시오.
Modified at 2026-06-09 08:53:32
Previous
테스트 시나리오 생성
Next
흐름 제어 조건
Built with