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. 자동 테스트
  • Back to home
  • 지원 센터
  • Apidog 지원 센터
  • 가져오기/내보내기
    • API 데이터를 Apidog로 가져오는 방법은 무엇입니까?
    • Apidog에서 cURL을 가져오는 방법은 무엇입니까?
    • Postman 환경을 Apidog로 마이그레이션하는 방법
    • Swagger/OpenAPI 가져오기 시 엔드포인트를 자동으로 그룹화하는 방법은 무엇입니까?
  • 요청 보내기
    • Apidog는 Socket.IO를 지원합니까?
    • 매개변수 값의 "+"가 공백으로 디코딩되는 이유는 무엇입니까?
    • Apidog에서 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 GraphQL 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 gRPC 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 SOAP/WebService 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 WebSocket 요청을 보내는 방법은 무엇입니까?
    • Apidog는 WebSocket API에서 사전 요청/테스트 스크립트 및 어서션을 지원합니까?
    • Apidog에서 SSE 요청을 보내는 방법은 무엇입니까?
    • 폴더 수준에서 기본 헤더를 추가하는 방법은 무엇입니까?
    • Apidog는 gRPC API에서 사전 요청/테스트 스크립트와 어서션을 지원합니까?
    • ELANREFUSED.DNS Resolver 오류
    • 요청을 보낼 때 "socket hang up" 오류가 발생하는 이유는 무엇입니까?
    • 요청 오류 수정
      • read ECONNRESET 오류 해결하기
      • ECONNREFUSED 오류 해결
      • ETIMEDOUT 오류 해결
      • ENOTFOUND: Couldn't resolve host 오류 해결
      • ENOTFOUND 해결: getaddrinfo ENOTFOUND www 오류
      • connect EHOSTUNREACH 오류 해결
  • API 설계
    • 경로에서 변수를 어떻게 사용합니까?
    • 응답 컴포넌트를 기본 응답으로 사용할 수 있습니까?
    • 엔드포인트를 수정한 사람을 확인하는 방법은 무엇입니까?
    • Apidog에서 엔드포인트 폴더를 일괄 삭제하려면 어떻게 해야 합니까?
    • 엔드포인트의 경로에 접두사를 일괄 추가/제거하려면 어떻게 해야 합니까?
    • Schema Editor에서 Property의 수준을 이동하는 방법은 무엇입니까?
    • 문자열 속성에 여러 열거형 값이 있고 다양한 위치에서 사용되는 경우, 이 enum을 전체에서 일관되게 참조하려면 어떻게 해야 합니까?
    • Apidog 리소스 폴더 ID를 얻는 방법은 무엇입니까?
    • Apidog의 리소스 폴더 ID는 어떻게 확인합니까?
    • URL 경로에서 변수를 어떻게 사용합니까?
    • 엔드포인트, 문서 또는 테스트 시나리오가 실수로 삭제된 경우 어떻게 해야 합니까?
    • Apidog는 사용자 지정 엔드포인트에 대한 요청 코드를 지원합니까?
    • Swagger/OpenAPI를 Apidog로 가져올 때 엔드포인트를 자동으로 그룹화하는 방법은 무엇입니까?
    • 목 응답에서 중복되지 않는 배열 데이터를 생성하려면 어떻게 해야 합니까?
    • 경로에서 "#" 입력이 지원되지 않는 이유는 무엇입니까?
  • API 디버깅
    • Apidog는 타사 키 관리 시스템과 어떻게 통합됩니까?
    • 동일한 요청이 다른 도구(예: Postman)에서는 정상적으로 작동하지만 Apidog에서는 작동하지 않는 이유는 무엇입니까?
    • Apidog에서 데이터베이스로부터 변수 값을 가져오는 방법은 무엇입니까?
    • 다른 도구에서 Apidog으로 환경을 마이그레이션하는 방법은 무엇입니까?
    • Apidog에서 스크립트를 사용하여 어서션하는 방법은 무엇입니까?
    • JSONPath는 배열만 추출할 수 있습니다. Apidog에서 배열 내부의 단일 요소를 어떻게 추출할 수 있습니까?
    • 서로 다른 환경에서 데이터베이스 계정 자격 증명이 다른 경우 Apidog에서 데이터베이스 작업을 구성하는 방법은 무엇입니까?
    • 사용자 지정 스크립트에서 서비스 기본 URL을 가져오는 방법은 무엇입니까?
    • API 응답이 너무 클 때 Apidog에서 최대 Node.js 문자열 길이 초과 오류가 보고되는 이유는 무엇입니까?
    • 콘솔 출력의 크기 제한은 얼마입니까? 큰 파일을 출력할 때 오류가 발생하는 이유는 무엇입니까?
    • Windows에서 DB2 데이터베이스 연결 오류를 해결하는 방법은 무엇입니까?
    • Apidog에서 Oracle 데이터베이스에 연결할 때 NJS-045 오류가 발생하는 이유는 무엇입니까?
    • Apidog 사용자 지정 스크립트에서 동적 값을 생성하는 방법은 무엇입니까?
    • 동일한 엔드포인트에 대한 클라이언트 요청은 성공하지만, 웹 측에서 디버깅할 때 "주소를 요청할 수 없습니다" 오류가 발생하는 이유는 무엇입니까?
    • 응답이 너무 클 때 Apidog에서 오류가 보고되는 이유는 무엇입니까?
    • Apidog 기록 엔드포인트는 어떻게 사용합니까?
    • 엔드포인트 응답을 정의할 때, 엔드포인트에 응답 콘텐츠가 없어도 됩니까?
    • 사용자 지정 스크립트에서 서비스 baseURL을 어떻게 가져옵니까?
    • Apidog에서 원본 패킷을 보려면 어떻게 해야 합니까?
    • 요청을 보낼 때 "Invalid URI xxx" 오류가 표시되는 이유는 무엇입니까?
    • Apidog 스크립트에서 비동기 요청을 수행하려면 어떻게 해야 합니까?
    • 요청을 보낼 때 "Couldn't resolve host" 메시지가 표시되는 이유는 무엇입니까?
    • 콘솔 출력 크기 제한은 무엇입니까? 큰 파일을 출력할 때 왜 오류가 발생합니까?
    • 엔드포인트 요청에서 파일을 업로드하려면 어떻게 해야 합니까?
    • Apidog가 충돌하거나 응답 데이터가 표시되지 않을 때의 조치 방법
    • OAuth2.0을 위해 Apidog에서 사용하는 공식 리디렉션 URI
  • Mock API 데이터
    • API를 자동으로 목하는 방법은 무엇입니까?
    • Apidog 목 기능으로 무엇을 할 수 있습니까?
    • Apidog에서 고정 API 데이터를 목하는 방법은 무엇입니까?
    • Apidog에서 조건부 데이터를 목하는 방법은 무엇입니까?
    • Apidog에서 클라우드 목을 활성화하는 방법은 무엇입니까?
    • Apidog에서 자체 호스팅 목을 활성화하려면 어떻게 해야 합니까?
    • Apidog는 WebSocket API 목을 지원합니까?
    • 브라우저가 목 엔드포인트를 요청할 때 콘텐츠를 반환하지 않는 이유는 무엇입니까?
  • 자동 테스트
    • 로컬 클라이언트에서는 테스트 시나리오가 문제없이 실행되지만, Apidog CLI 또는 러너에서 실행할 때 오류가 발생하는 이유는 무엇입니까?
    • Apidog에서 테스트 시나리오를 생성하는 방법은 무엇입니까?
    • 테스트 단계 간에 데이터를 전달하는 방법은 무엇입니까?
    • 사전 단계 데이터를 성공적으로 참조할 수 없는 이유는 무엇입니까?
    • Apidog에서 foreach 루프를 사용하는 방법은 무엇입니까?
    • 엔드포인트/엔드포인트 케이스의 데이터 동기화에는 어떤 차이가 있습니까?
    • Apidog에서 테스트 데이터를 사용하는 방법
    • Apidog에서 스크립트로 테스트 데이터를 가져오는 방법은 무엇입니까?
    • Apidog에서 테스트 시나리오를 일괄 실행하는 방법은 무엇입니까?
    • Apidog에서 테스트 작업을 예약하는 방법은 무엇입니까?
    • Apidog에서 성능 테스트를 실행하는 방법은 무엇입니까?
    • 성능 테스트에서 실제 요청과 응답을 어떻게 확인할 수 있습니까?
    • Apidog에서 성능 테스트 보고서를 어떻게 내보낼 수 있습니까?
    • 데이터베이스 쿼리 결과를 반복 API 요청의 매개변수로 사용하는 방법은 무엇입니까?
    • CI/CD 중 ApiDog에서 Stripe 웹훅 캡처 및 검증
    • Runner에서 "Error: unable to verify the first certificate on runner" 오류를 해결하는 방법은 무엇입니까?
    • General Runner Docker 컨테이너 "Not Found" 오류.
    • Apidog 웹 버전에서 General Runner의 서버 호스트를 설정하는 방법은 무엇입니까?
    • 예약된 테스트 시나리오가 0개의 요청으로 종료된 이유는 무엇입니까?
    • Runner 또는 CLI에서 파일 업로드 매개변수를 찾을 수 없는 경우 어떻게 해야 합니까?
    • 업로드 파일 단계가 있는 테스트 시나리오를 Runner로 실행하는 방법은 무엇입니까?
    • Runner에서 "Error: unable to verify the first certificate on runner" 오류를 해결하려면 어떻게 해야 합니까?
    • Runner에 문제가 발생했을 때 문제를 식별하기 위해 Runner 로그에 접근하고 검색하려면 어떻게 해야 합니까?
    • 엔드포인트 매개변수가 업로드 파일이며 Runner 또는 CLI에서 찾을 수 없는 경우 어떻게 해야 합니까?
    • API 사용 사례가 변경될 때 테스트 단계가 자동으로 동기화되지 않는 이유는 무엇입니까?
    • Markdown 문서에서 여러 개의 달러 기호를 사용하면 일부 콘텐츠가 올바르게 표시되지 않는 이유는 무엇입니까?
    • 자체 호스팅 Runner는 작업 실행 후 서버에 테스트 보고서를 생성합니까?
    • 테스트 시나리오의 요청에 통합 사전/사후 프로세서를 추가할 수 있습니까?
    • 단일 자동화 테스트 실행 중 동적 값을 일관되게 유지하려면 어떻게 해야 합니까?
  • API 문서 게시
    • 게시된 문서에서 모든 Apidog 로고를 숨기는 방법은 무엇입니까?
    • API 사양이 업데이트되면 API 문서도 변경됩니까?
    • Apidog에서 협업자에게 API를 공유하는 방법은 무엇입니까?
    • Apidog 문서의 도메인을 사용자 지정하는 방법은 무엇입니까?
    • Apidog에서 다중 버전 문서를 생성하는 방법은 무엇입니까?
    • Apidog에서 Publish Docs Sites의 공유 범위
    • Apidog에서 Share Doc 목록의 공유 범위
    • 게시된 Share Docs에 호스트 이름이 표시되지 않는 이유는 무엇입니까?
    • 공유 문서에서 문서 사용자가 Base URL을 수정하려면 어떻게 해야 합니까?
    • 게시된 Apidog 문서를 복제하여 제 프로젝트에서 사용할 수 있습니까?
    • Apidog 온라인 문서에서 헤더(예: 토큰)를 공유하는 방법은 무엇입니까?
    • 팀원이 게시된 문서를 찾을 수 없는 이유는 무엇입니까?
    • 사용자 지정 도메인에서 SSL 인증서 만료 또는 Cloudflare 526 오류를 어떻게 해결합니까?
    • 사용자 지정 SMTP가 성공적으로 구성되었지만 허용 목록 사용자가 OTP 이메일을 받지 못함
  • Markdown
    • Apidog 내의 다양한 페이지 또는 엔드포인트에 연결하기 위해 카드를 사용하는 방법은 무엇입니까?
    • Markdown 문서에서 여러 개의 $ 기호를 사용할 때 일부 콘텐츠가 올바르게 표시되지 않는 이유는 무엇입니까?
    • Apidog Markdown에서 투명 배경 이미지를 사용하는 방법은 무엇입니까?
    • Markdown 표의 열 너비를 설정하는 방법은 무엇입니까?
    • Markdown 문서에 내부 API, 문서, 데이터 스키마 또는 폴더를 삽입하려면 어떻게 해야 합니까?
    • Apidog 카드 컴포넌트에서 프로젝트 내 문서 또는 엔드포인트에 링크를 추가하려면 어떻게 해야 합니까?
  • 브랜치
    • 스프린트 브랜치에 어떻게 접근합니까?
  • 관리
    • Apidog 클라이언트를 자동 설치하는 방법은 무엇입니까?
    • 관리자 권한이 있음에도 'No Permission' 오류가 표시되는 이유는 무엇입니까?
    • 러너 버전 번호는 어떻게 확인합니까?
    • Apidog는 Windows 7을 지원합니까?
    • Apidog 설치 후 "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" 오류가 표시되는 이유는 무엇입니까?
    • 구독 변경 및 환불
    • 웹 요청은 작동하지만 앱에서 "read ECONNRESET"이 발생하는 이유는 무엇입니까?
    • Windows 시스템 업데이트 후 Apidog을 열 수 없는 이유는 무엇입니까?
    • Windows 시스템 업데이트 후 Apidog가 열리지 않는 이유
  • 청구
    • Apidog에서 팀을 위한 별도의 결제 계정을 설정할 수 있습니까?
    • Apidog에서의 팀 액세스 및 청구 문제
    • 초대된 팀원이 Apidog에 액세스할 수 없습니다.
    • 개인 유료 팀을 조직으로 이전하기
  • 온프레미스
    • Apidog Self-Hosted(Enterprise) 버전의 사용자 및 액세스 관리
  • 웹 및 클라이언트
    • Linux 데스크톱 버전 다운로드 및 설치
  1. 자동 테스트

테스트 단계 간에 데이터를 전달하는 방법은 무엇입니까?

자동화 테스트 시나리오에서는 여러 요청 간에 데이터를 전달하는 일이 매우 일반적입니다. 일반적인 사례는 다음과 같습니다.
요청 1은 토큰을 반환하는 로그인 요청이며, 요청 2는 이 토큰을 사용하여 다른 데이터를 요청합니다.
요청 1은 ID를 반환하며, 요청 2는 이 ID를 기반으로 작업을 수행합니다.
요청 1은 목록을 반환하며, 요청 2는 이 목록의 데이터를 사용합니다.
이러한 시나리오를 위해 Apidog는 요청 간 데이터 전달을 처리하는 두 가지 솔루션을 제공합니다. 당면한 특정 문제에 따라 적절한 솔루션을 선택하실 수 있습니다.
이전 단계 데이터 가져오기: 이 기능을 사용하면 후속 요청에서 이전 요청의 데이터를 직접 사용할 수 있습니다.
장점은 추가 변수를 도입할 필요가 없어 간단하다는 점입니다.
그러나 데이터를 여러 번 참조해야 하는 경우에는 다소 번거로워질 수 있습니다.
이전 단계 데이터 가져오기 기능은 "Tests" 모듈에서만 사용할 수 있으며, "APIs" 모듈에서는 사용할 수 없습니다.
변수 사용: 이전 요청의 전처리기에 "Extract Variables"를 추가하여 필요한 데이터를 변수에 저장한 다음, 후속 요청에서 이 변수를 호출합니다.
장점은 데이터를 여러 번 참조할 때 편리하다는 점이지만, 단일 참조의 경우에는 다소 복잡할 수 있습니다.
변수는 "Tests" 모듈과 "APIs" 모듈 모두에서 사용할 수 있습니다.

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

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

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

이전 문서의 {{$.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>}}
Cookie{{$.<step id>.response.cookie.<field name>}}
루프요소(ForEach 루프의 배열 요소){{$.<loop step id>.element.<field path>}}
인덱스{{$.<loop step id>.index}}

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

요청 1이 토큰을 반환하는 로그인 요청이고, 요청 2가 이 토큰을 사용하여 추가 데이터를 요청하는 시나리오를 살펴보겠습니다.
1
로그인 요청(요청 1)을 테스트 시나리오에 추가합니다.
2
요청 1의 후처리기에 "Extract Variable" 작업을 추가하여 $.token을 {{token}}으로 추출합니다.
Extract variable에 대해 자세히 알아보십시오.
3
조회 요청(요청 2)을 테스트 시나리오에 추가합니다.
4
요청 2의 쿼리 매개변수에서 변수 {{token}}을 참조합니다.
5
테스트 시나리오에서 "Run" 버튼을 클릭하면 요청 1의 데이터를 요청 2로 성공적으로 전달할 수 있습니다.
Modified at 2026-06-09 08:53:32
Previous
Apidog에서 테스트 시나리오를 생성하는 방법은 무엇입니까?
Next
사전 단계 데이터를 성공적으로 참조할 수 없는 이유는 무엇입니까?
Built with