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

엔드포인트 및 엔드포인트 케이스에서 데이터 동기화

엔드포인트/엔드포인트 케이스에서 가져온 테스트 단계의 경우, 해당 요청 데이터를 연결된 엔드포인트 명세/케이스와 동기화할 수 있습니다.
데이터 동기화
엔드포인트/엔드포인트 케이스를 테스트 단계로 가져올 때 수동 또는 자동 모드를 선택할 수 있습니다.
수동 모드는 여러 사람이 협업하는 시나리오에 적합합니다. 즉, 프로젝트에서 엔드포인트 명세, 개발, 테스트 프로세스가 모두 명확하게 업무가 분리되어 있으며 각 프로세스에 전담 담당자가 있는 경우를 의미합니다. 이러한 프로세스에서는 의도하지 않은 변경 사항이 서로에게 영향을 주지 않도록 데이터 독립성이 필요합니다. 엔드포인트 명세/케이스 데이터의 안정성을 확인한 후, 테스터가 이를 테스트 단계와 수동으로 동기화할 수 있습니다.
자동 모드는 소규모 팀 또는 독립 개발자에게 적합합니다. 즉, 프로젝트에서 엔드포인트 명세, 개발, 테스트 프로세스를 모두 단일 역할이 처리하여 엔드포인트 유지 관리 및 테스트의 효율성을 높이는 경우를 의미합니다. "Endpoint Management"의 엔드포인트/엔드포인트 케이스가 변경되면 테스트 단계의 엔드포인트/엔드포인트 케이스 데이터도 그에 따라 조정되어 "Endpoint Management"와 "Automated Testing" 간의 데이터 일관성이 보장됩니다.
동기화 모드

동기화 관계#

테스트 단계 가져오기 방법연결된 데이터테스트 단계 동기화 모드동기화 내용
엔드포인트에서 가져옴 - 수동 모드엔드포인트 명세수동 모드(테스트 단계에서 "Update" 버튼 클릭)✅ "매개변수 이름", "Path", "Method", "pre/post-actions" 등의 변경 사항

❌ "매개변수 값".
엔드포인트에서 가져옴 - 자동 모드엔드포인트 명세자동 모드(엔드포인트 명세가 업데이트되고 저장될 때)✅ "매개변수 이름", "Path", "Method", "pre/post-actions" 등의 변경 사항

❌ "매개변수 값".
엔드포인트 케이스에서 가져옴 - 복사엔드포인트 명세수동 모드(테스트 단계에서 "Update" 버튼 클릭)✅ "매개변수 이름", "Path", "Method", "pre/post-actions" 등의 변경 사항

❌ "매개변수 값".
엔드포인트 케이스에서 가져옴 - 참조엔드포인트 케이스자동 모드(엔드포인트 케이스가 업데이트되고 저장될 때)✅ 엔드포인트 케이스 데이터를 참조하며, 엔드포인트 케이스의 모든 변경 사항은 이 테스트 단계의 내용에 영향을 줍니다.

수동 동기화 모드#

수동 모드를 선택하면 연결된 버튼이 "파란색"으로 표시됩니다. "Endpoint Management"의 엔드포인트 명세에 변경 사항이 있더라도 테스트 단계의 데이터는 실시간으로 업데이트되지 않습니다. 테스터는 "Test Steps" 세부 정보에서 "Update" 버튼을 수동으로 클릭하여 엔드포인트/엔드포인트 케이스의 변경 사항을 테스트 단계로 동기화할 수 있습니다.
이 모드는 테스터가 요청 매개변수를 세부 조정해야 하는 요청이 많은 테스트 시나리오에 적합합니다. 이를 통해 해당 테스트 데이터에 의도하지 않은 영향이 발생하는 것을 방지하고, 테스트 데이터와 개발 중인 엔드포인트의 데이터 간 격리를 보장할 수 있습니다.
수동 동기화
데이터 동기화
수동 모드에서는 연결된 버튼의 드롭다운 메뉴를 통해 데이터 동기화 범위를 수동으로 필터링할 수도 있습니다.
동기화 필터링

엔드포인트 명세 동기화#

Endpoint → Manual update를 가져오거나 엔드포인트 케이스 → 복사에서 가져와 생성된 테스트 단계의 경우, 연결된 내용은 엔드포인트 명세입니다. 이러한 테스트 단계는 페이지의 "Sync Now" 버튼을 클릭하여 엔드포인트 명세 내용과 동기화할 수 있습니다.
수동 동기화를 트리거하면 테스트 단계는 "매개변수 이름", "pre/post-scripts" 등을 포함하여 엔드포인트 명세의 데이터를 동기화합니다. 동기화 대상은 엔드포인트 명세이며, 엔드포인트 명세의 요청 매개변수에 샘플 값이 설정되어 있지 않은 경우 동기화된 내용에는 "매개변수 값"이 포함되지 않습니다.
"Endpoint Spec"의 데이터를 저장하고 업데이트해도 연결된 테스트 단계에는 영향을 주지 않습니다.
엔드포인트 명세 동기화
테스트 단계에서 "Update" 버튼을 클릭하면 데이터 동기화 메커니즘이 트리거되며, 버튼에는 "Synced"가 표시됩니다. 동기화된 데이터가 올바른지 확인한 후에는 오른쪽 위 모서리의 "Save" 버튼을 클릭하여 테스트 단계를 저장해야 합니다.
동기화 저장

데이터 일괄 동기화#

현재 테스트 단계의 대부분 데이터가 수동 모드를 사용하고 있으며, 테스터가 해당 엔드포인트 명세/케이스의 데이터가 올바르다고 확인하고 데이터를 테스트 단계로 빠르게 동기화하려는 경우, 테스트 단계 페이지의 "Update" 버튼을 클릭하여 일괄 동기화 작업을 수행할 수 있습니다.
일괄 동기화

자동 동기화 모드#

연결된 버튼은 주황색으로 표시됩니다. 앞서 언급한 것처럼 이 모드는 단독 개발자가 흐름을 직접 제어하고 추적하는 데 도움이 됩니다.
자동 동기화

엔드포인트 명세 동기화#

엔드포인트 명세와 연결된 테스트 단계의 경우, 동기화 모드가 자동 동기화로 설정되어 있으면 엔드포인트 명세에 변경 사항이 있고 저장될 때 해당 데이터가 테스트 단계에서 실시간으로 업데이트됩니다. 동기화되는 내용은 앞서 설명한 수동 동기화 모드와 동일합니다.
엔드포인트 자동 동기화
자동 모드에서는 테스트 단계의 데이터와 엔드포인트 명세 간의 불일치 항목이 강조 표시됩니다. 테스터는 엔드포인트 명세와 완전한 일관성을 유지하기 위해 "Revert"를 선택할 수 있으며, 또는 테스트 단계의 데이터로 엔드포인트 명세의 데이터를 덮어써 일관성을 유지하기 위해 "Save to Document"를 선택할 수도 있습니다.
불일치 항목 강조 표시

엔드포인트 케이스 동기화#

테스트 단계에서 참조되는 엔드포인트 케이스의 데이터를 관리할 때 일관성과 고유성을 보장하려면, "Endpoint Management" 시스템에서 참조된 엔드포인트 케이스를 조정하여 엔드포인트 케이스와 테스트 단계가 동일한 요청 데이터를 사용하도록 해야 합니다.
테스트 단계 페이지의 안내에서 "Edit" 버튼을 클릭하면 연결된 엔드포인트 케이스 페이지로 이동하여 조정할 수 있습니다. 엔드포인트 케이스가 변경된 후 테스트 단계는 "매개변수 이름", "매개변수 값", "pre/post-scripts" 및 기타 모든 요청 내용을 포함한 데이터를 자동으로 동기화합니다.
엔드포인트 케이스 동기화
Modified at 2026-06-09 08:53:32
Previous
흐름 제어 조건
Next
다른 프로젝트에서 엔드포인트 및 엔드포인트 케이스 가져오기
Built with