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. 테스트 시나리오

테스트 시나리오 생성

Apidog 테스트에서 테스트 시나리오는 Postman의 Collection과 유사한 기본 단위입니다. 여러 요청을 연속으로 전송하거나, 연속적인 테스트 시나리오를 구축하거나, 서로 다른 테스트 데이터로 요청을 반복해야 하는 경우 테스트 시나리오를 생성하고 필요한 요청을 추가할 수 있습니다.

테스트 시나리오의 이점#

Apidog에서 테스트 시나리오를 사용하면 다양한 API 테스트 요구 사항을 효율적으로 충족할 수 있습니다.
기능설명
순차적 요청 실행사용자 상호 작용 또는 프로세스 흐름을 시뮬레이션하기 위해 여러 요청을 지정된 순서로 구성하고 실행합니다.
테스트 보고어서션 및 개별 요청 결과에 대한 상세한 시각화를 제공하는 보고서를 자동으로 생성합니다.
CI/CD 통합테스트 시나리오를 CI/CD 파이프라인에 통합하여 개발 주기 중 자동 테스트를 보장하고, 문제를 조기에 발견할 수 있도록 합니다.
성능 테스트다양한 부하에서 API 성능을 평가하고, 시간에 따른 응답 동작의 변화를 식별하기 위해 추세 분석을 생성합니다.
동적 매개변수 테스트동적으로 생성된 매개변수를 사용하여 요청을 여러 번 실행함으로써 API가 가변 입력을 처리하는 방식을 테스트합니다.
사전 정의된 테스트 데이터현실적인 운영 조건을 시뮬레이션하고 예상 출력과 비교하여 API 응답을 검증하기 위해 요청에 사전 설정된 데이터를 활용합니다.
요청 간 데이터 전달한 요청의 출력에서 다른 요청으로 데이터를 자동으로 전달합니다. 이는 호출 간 상태 지속성이 필요한 API를 테스트하는 데 중요합니다.
논리적 요청 관계이전 요청의 결과 또는 특정 조건에 따라 실행 흐름을 관리하기 위해 if, for, foreach와 같은 논리 조건을 구성합니다.
이러한 기능을 통해 견고하고 고품질의 API 개발에 기여하는 다목적이고 효과적인 테스트 환경을 만들 수 있습니다.

테스트 시나리오 생성#

Apidog을 열면 "Tests" 모듈로 이동한 다음, 검색 창 옆의 +를 클릭하여 새 테스트 시나리오를 생성하십시오. 적절한 디렉터리를 선택하고 우선순위를 설정하여 생성을 완료하십시오.
새 테스트 시나리오 생성

테스트 단계 추가#

Apidog에서 테스트 시나리오를 설정한 후에는 요청을 채워 넣기 시작할 수 있습니다. 요청을 추가하는 방법은 여러 가지가 있으며, 각각은 서로 다른 요구 사항과 유연성에 맞게 설계되어 있습니다.

엔드포인트 사양에 연결된 요청#

이러한 요청은 엔드포인트 사양이 변경됨에 따라 업데이트될 수 있습니다.

엔드포인트 사양에서 가져오기#

현재 프로젝트의 엔드포인트 사양을 테스트 시나리오의 단계로 가져올 수 있습니다. 엔드포인트를 가져올 때는 "Manual" 및 "Automated"의 두 가지 모드가 있습니다. 자세한 지침은 엔드포인트/엔드포인트 케이스에서 데이터 동기화를 참조하십시오.
Manual 모드
"Manual" 모드에서는 프로젝트 내 엔드포인트 문서에 대한 수정 사항이 테스트 단계의 엔드포인트에 즉시 영향을 주지 않습니다. 테스트 데이터 동기화는 테스터가 "Manual" 버튼을 활성화할 때만 수행됩니다. 테스트 단계 데이터에 대한 변경 사항은 "Manual Sync"를 클릭하더라도 엔드포인트 문서를 업데이트하지 않는다는 점에 유의해야 합니다. 대신 이 버튼을 클릭하면 테스트 시나리오가 동기화 목적으로 엔드포인트 문서에서 정보를 가져올 수 있습니다.
Automated 모드
"Automated" 모드에서는 프로젝트 내 엔드포인트 문서의 모든 변경 사항이 테스트 단계에 동기식으로 업데이트됩니다.
Manual 및 Automated 모드
하나의 테스트 시나리오에서 다른 프로젝트의 엔드포인트를 테스트해야 하는 경우 다른 프로젝트에서 테스트 단계로 엔드포인트/케이스 가져오기를 참조하십시오.

엔드포인트 케이스에서 가져오기#

현재 프로젝트 또는 다른 프로젝트에서 엔드포인트 케이스를 가져오도록 선택할 수 있습니다. 엔드포인트 케이스를 가져올 때는 "Copy" 및 **"Reference"**의 두 가지 모드가 있습니다.
Copy 모드
엔드포인트 케이스를 **"Copy"**로 가져오면 엔드포인트 케이스의 매개변수도 테스트 단계로 복사됩니다. 이들은 서로 독립적이며, 각각의 변경 사항은 서로에게 영향을 주지 않습니다. 수동 동기화를 선택할 수 있습니다.
Reference 모드
엔드포인트 케이스를 **"Reference"**로 가져오면 요청에 대해 원본 프로젝트의 엔드포인트 케이스를 직접 사용합니다.
Copy 및 Reference 모드
테스트 단계가 케이스에서 참조된 경우, 이 단계를 수정하면 원본 엔드포인트 케이스와 이를 사용하는 다른 모든 단계에도 영향을 준다는 메시지가 표시됩니다.
참조된 케이스 안내

API 사양과 연결되지 않은 독립 요청#

이러한 요청은 API 사양의 변경에 따라 업데이트되지 않습니다. 더 높은 수준의 사용자 지정을 허용합니다.

사용자 지정 요청 추가#

작업 프로세스에서는 타사 결제 엔드포인트와 같이 프로젝트 외부의 엔드포인트를 호출해야 할 수 있습니다.
테스트 단계에 사용자 지정 API 요청을 추가할 수 있습니다. 사용자 지정 요청은 일반적인 GET, POST, PUT, DELETE 등을 포함한 모든 HTTP 요청일 수 있습니다.

cURL에서 추가#

실제 작업 프로세스에서는 많은 엔드포인트 요청이 cURL 명령줄 형태로 제공됩니다. 클릭 한 번으로 cURL 요청을 테스트 단계로 가져올 수 있습니다.

다른 테스트 시나리오 참조#

다른 테스트 시나리오의 단계 포함#

동일한 프로젝트 내의 다른 테스트 시나리오에서 가져와 테스트 단계 또는 프로세스 제어 조건을 복제할 수 있습니다.
다른 시나리오의 단계 포함

다른 테스트 시나리오 참조#

다른 테스트 시나리오를 테스트 단계로 참조할 수 있습니다. 사용 사례는 두 가지입니다.
1.
비즈니스 프로세스에 공통적이고 재사용 가능한 API 테스트 단계가 있는 경우, 이러한 단계를 작은 테스트 시나리오로 구성한 다음 다른 더 큰 테스트 시나리오에서 직접 참조할 수 있습니다.
2.
전체 제품의 주요 프로세스를 회귀 테스트해야 하는 경우, 테스트 시나리오에서 다양한 하위 테스트 시나리오를 참조하여 조립하고, 클릭 한 번으로 모든 주요 프로세스의 테스트 회귀 작업을 완료할 수 있습니다.
무한 루프 및 테스트 시나리오가 정상적으로 실행을 중지할 수 없는 상황을 방지하기 위해, 다른 테스트 시나리오를 참조하는 기능은 원본 테스트 시나리오 자체를 참조할 수 없습니다.

테스트 시나리오 오케스트레이션#

아무 테스트 단계나 클릭하면 오케스트레이션 모드로 들어갑니다. 이 모드에서는 각 테스트 단계의 상세 내용을 더 쉽고 효율적으로 입력할 수 있도록 더 큰 작업 페이지가 제공됩니다. 페이지의 왼쪽은 테스트 시나리오의 전체 흐름이고, 오른쪽은 선택한 테스트 단계의 세부 정보입니다. 엔드포인트 요청과 테스트 프로세스 제어 구성 요소는 서로 다른 표시 패널을 갖습니다.
단계 앞의 ≡를 드래그하여 단계 순서를 조정할 수 있습니다.
이 모드에서는 "⬆️" 및 "⬇️" 키를 사용하여 선택한 테스트 단계 간에 빠르게 전환할 수 있습니다.
오케스트레이션 모드 개요
오케스트레이션 모드에서는 여러 단계를 편집한 다음 왼쪽 상단 모서리의 "Save All" 버튼을 클릭하여 모든 변경 사항을 저장할 수 있습니다.
저장되지 않은 변경 사항이 있는 단계가 있으면 해당 단계는 왼쪽 목록 표시줄에 점으로 표시됩니다. 변경한 내용은 항상 저장해야 한다는 점을 기억하십시오.
저장되지 않은 변경 사항 표시기
Modified at 2026-06-09 08:53:32
Previous
개요
Next
요청 간 데이터 전달
Built with