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. API 개발 및 디버깅
  • 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. API 개발 및 디버깅

테스트 케이스

Apidog 버전 2.7.29부터 엔드포인트 상세 페이지에서 직접 테스트 케이스를 추가할 수 있습니다.
각 테스트 케이스는 해당 엔드포인트에 대한 요청 매개변수 세트를 나타냅니다. 사용자는 모든 테스트 케이스를 체계적으로 구성하고 관리한 다음, 한 번의 클릭으로 실행하여 현재 엔드포인트에 대한 테스트를 완료할 수 있습니다.
테스트 케이스 vs. 디버그 케이스
테스트 케이스
목적: 다양한 요청 시나리오에서 엔드포인트가 예상대로 동작하는지 확인하며, 포괄성에 중점을 둡니다.
광범위한 시나리오를 다룹니다: 정상, 비정상, 경계값, 보안.
일반적으로 수정하거나 실행하는 빈도가 낮습니다.
디버그 케이스
목적: 개발 또는 문제 해결 중 엔드포인트 응답을 빠르게 확인하며, 속도에 중점을 둡니다.
일반적으로 성공 및 실패와 같은 기본 시나리오로 제한됩니다.
자주 수정하고 실행하는 경우가 많습니다.

테스트 케이스 생성#

다음과 같은 여러 방법으로 테스트 케이스를 생성할 수 있습니다.

1. 수동 생성#

엔드포인트 상세 페이지의 Test Cases 탭에서 + Add Case를 클릭하여 수동으로 생성합니다.

2. 디버그 케이스에서 가져오기#

테스트 케이스를 추가할 때 Import from Debug Cases를 선택하여 기존 디버그 케이스를 테스트 케이스로 복사하거나 이동할 수 있습니다.
복사: 빠른 검증을 위해 디버그 케이스가 여전히 필요하지만, 동시에 테스트 케이스로도 사용하려는 경우에 사용하십시오.
이동: 해당 디버그 케이스가 더 이상 디버깅에 자주 사용되지 않고, 주로 예외 테스트를 위해 작성된 경우에 사용하십시오. 이를 통해 해당 케이스를 테스트 케이스로 직접 변환할 수 있으므로, 원래 테스트 케이스가 디버그 케이스로 작성되어 있었다면 더 빠르게 마이그레이션할 수 있습니다.

테스트 케이스 세부 정보#

테스트 케이스에는 다음 정보가 포함됩니다.
그룹: 테스트 목적(정상, 비정상, 경계값 등)에 따라 구성됩니다.
케이스 이름: 테스트 케이스의 이름입니다.
요청 매개변수: Path, Query, Header 및 form-data Body 매개변수입니다.
요청 본문: RAW, JSON, XML 등을 지원합니다.
사전/사후 프로세서
응답 검증: 검증을 활성화/비활성화하고 검증할 응답 구성 요소를 지정합니다.
[!NOTE]
테스트 케이스는 업데이트 빈도가 낮으므로 엔드포인트 변경 사항과 수동으로 동기화해야 합니다. 예를 들어 엔드포인트에 새 필드가 추가된 경우, 테스트 케이스에서 Update를 클릭하여 업데이트해야 합니다.
테스트 케이스 세부 정보를 편집한 경우 Save를 클릭하여 저장해야 합니다. 저장되지 않은 변경 사항이 있으면 시스템에서 안내 메시지를 표시합니다.

테스트 케이스 관리#

Test Cases 탭에서 생성된 모든 테스트 케이스를 관리할 수 있습니다. 왼쪽 상단의 검색 및 필터 기능을 사용하여 필요한 테스트 케이스를 쉽게 찾을 수 있습니다. 또한 그룹 탭을 사용하여 그룹별 테스트 케이스를 빠르게 확인할 수도 있습니다. 특정 테스트 케이스에 대한 작업은 다음과 같습니다.
단일 테스트 케이스: 새 탭을 열어 테스트 케이스를 확인, 수정 및 실행할 수 있습니다. 기본 작업에는 복사, 테스트 케이스를 다른 그룹으로 이동, 테스트 케이스의 cURL 복사, 테스트 케이스 삭제가 포함됩니다.
여러 테스트 케이스: 목록에서 여러 테스트 케이스를 선택하면 오른쪽 상단에 작업 버튼이 표시되며, 이를 통해 일괄 그룹 지정, 삭제 및 엔드포인트 업데이트와의 동기화를 수행할 수 있습니다.

테스트 케이스 실행#

테스트 케이스를 확인하는 중 Run 버튼을 클릭하면 해당 매개변수로 요청을 전송합니다. 그러면 실제 응답이 표시됩니다.
Run All을 사용하거나 목록에서 여러 테스트 케이스를 선택하여 함께 실행할 수도 있습니다. 인터페이스에는 현재 실행 중인 케이스와 결과가 있는 케이스가 표시됩니다.
일괄 실행 후 테스트 케이스를 열어 실행 결과를 직접 확인할 수 있습니다.

테스트 보고서#

테스트를 일괄 실행한 후 오른쪽 상단의 Test Reports에서 모든 과거 보고서를 확인할 수 있습니다.
보고서를 클릭하면 상세 결과를 확인할 수 있어 이슈 추적 및 분석에 도움이 됩니다.
테스트 케이스가 작동하는 방식의 개요는 다음과 같습니다.

단일 엔드포인트 테스트 모범 사례#

단일 엔드포인트 테스트에는 일반적으로 백엔드 개발자와 QA 엔지니어라는 두 가지 역할이 포함됩니다.
백엔드 개발자: 엔드포인트 코드를 작성하고 디버그합니다.
QA 엔지니어: 포괄적인 API 테스트를 수행하고 이슈를 식별합니다.
이제 Apidog에서 엔드포인트에 대한 테스트 케이스를 지원하므로 워크플로를 더 효율적으로 만들 수 있습니다.
QA 엔지니어는 엔드포인트 문서 내에서 직접 단위 테스트 케이스를 작성하고 관리할 수 있습니다.
개발자는 기존 테스트 케이스를 사용하여 테스트를 실행하고, 결과를 확인하며, QA 엔지니어의 피드백이나 긴 커뮤니케이션을 기다리지 않고 직접 이슈를 수정할 수 있습니다.
모범 사례 워크플로:
이 워크플로는 협업 효율성을 높일 수 있습니다.
1.
엔드포인트 문서가 확정된 직후 테스트 케이스를 작성할 수 있으며, Apidog의 모든 팀원이 확인할 수 있습니다.
2.
개발자는 디버깅 후 QA 엔지니어를 기다릴 필요 없이 직접 엔드포인트를 테스트할 수 있습니다.
3.
개발자는 테스트 결과를 기반으로 이슈를 직접 수정할 수 있으며, 추가 티켓이나 인수인계가 필요하지 않습니다.
4.
명확한 테스트 결과를 통해 문제 설명이 간단해져 오해를 방지할 수 있습니다.
Modified at 2026-06-09 08:53:32
Previous
디버깅 케이스
Next
동적 값
Built with