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. 브랜치

스프린트 브랜치 병합

엔드포인트 정의가 스프린트 브랜치 내에서 개발되고 배포되면, 변경 사항의 일부 또는 전체를 메인 브랜치로 병합할 수 있습니다.

병합 기능에 액세스하기#

APIs의 경우#

옵션 1: APIs 옆의 브랜치 전환에서 병합을 클릭하십시오.
옵션 2: APIs의 오른쪽 하단에서 메인으로 병합을 클릭하십시오.
스프린트 브랜치 병합 진입점

테스트 시나리오의 경우#

테스트 시나리오는 별도로 병합해야 하며, APIs의 리소스와 자동으로 병합되지 않습니다.
스프린트 브랜치에서 자동화 테스트의 테스트 시나리오 옆에 있는 ... 버튼 위에 마우스를 올리면 메인으로 병합 옵션을 확인할 수 있습니다.
테스트 시나리오 병합 진입점

보호되지 않은 메인 브랜치로 병합하기#

메인 브랜치가 보호되어 있지 않은 경우, 프로젝트 병합 권한이 있는 사용자는 변경 사항을 검토하고 메인 브랜치로 직접 병합할 수 있습니다.

보류 중인 병합 개요#

병합을 클릭하면 주요 요소가 포함된 병합 개요 팝업이 열립니다.
요소설명
필터현재 스프린트 브랜치에서 수정된 리소스만 보거나 모든 리소스를 봅니다.
병합 미리보기병합 후 메인 브랜치 디렉터리에 최종적으로 적용될 결과를 표시합니다.
리소스 상태색상으로 구분된 점입니다(회색: 변경 없음, 주황색: 수정됨, 녹색: 신규).
병합 후 상태병합된 리소스 상태를 조정하는 방법을 선택합니다: 현재 브랜치 따르기, 메인 따르기 또는 지정된 상태.
병합 개요

보류 중인 병합의 상세 검토#

리소스를 클릭하면 팝업이 확장되고, 병합 의사 결정을 위한 상세 콘텐츠가 표시됩니다.

신규 리소스#

현재 스프린트 브랜치에서 생성되었으며 메인 브랜치에는 없는 리소스입니다.
병합하면 해당 리소스가 지정된 위치에 메인 브랜치에 생성됩니다.
클릭하여 전체 콘텐츠를 확인하십시오.
신규 리소스 상세 정보

수정된 리소스#

메인 브랜치에서 포크되었으며 메인 브랜치 리소스와 연결된 리소스입니다.
병합하면 메인 브랜치 리소스를 덮어씁니다.
클릭하여 메인 브랜치 리소스와 비교한 변경 사항 및 전체 콘텐츠를 확인하십시오.
수정된 리소스 상세 정보

변경되지 않은 리소스#

메인 브랜치에서 포크되었지만 수정되지 않은 리소스입니다.
병합 대상으로 선택할 수 없습니다(선택할 필요도 없습니다).
상세 콘텐츠는 표시되지 않습니다.
변경되지 않은 리소스 상세 정보
상위 리소스가 선택되지 않은 경우, 해당 하위 리소스는 개별적으로 병합할 수 없습니다.
병합 확인:
병합 확인 팝업
병합 완료:
병합 후에는 메인 브랜치에 적용된 변경 사항을 보여 주는 요약 팝업이 표시됩니다.
병합 완료 팝업

병합 상세 정보 보기 및 병합 되돌리기#

메인 브랜치에서 리소스의 변경 기록에 액세스하여 다음을 수행할 수 있습니다.
병합을 통해 수정된 콘텐츠 보기
다른 버전과 콘텐츠 비교하기
변경 사항 추적 및 롤백하기
메인 브랜치 리소스 기록
리소스 기록 비교

보호된 메인 브랜치로 병합하기#

보호된 메인 브랜치로 병합할 때는 편집 권한이 있는 사용자가 관리자 검토 및 승인을 위해 병합 요청을 생성해야 합니다.

병합 요청 생성하기#

1.
프로젝트에서 병합을 클릭하십시오.
2.
현재 브랜치의 모든 변경 사항을 확인하십시오.
3.
병합할 특정 리소스를 선택하십시오.
4.
오른쪽 하단의 병합 요청 생성을 클릭하십시오.
병합 요청 생성

병합 요청 검토하기#

검토자는 프로젝트 개요에서 새 병합 요청이 있음을 알리는 알림을 확인할 수 있습니다.
검토 방법:
1.
프로젝트 개요 → 병합 요청으로 이동하십시오.
2.
상세 정보가 포함된 요청 목록을 확인하십시오.
병합 요청 목록
3.
보류 중인 병합 요청을 클릭하여 내용을 평가하십시오.
4.
병합 전후의 콘텐츠를 비교하십시오.
5.
병합을 클릭하여 변경 사항을 승인하고 병합하십시오.
병합 요청 검토
병합 완료:
수정 사항 개요
병합됨 상태:
병합된 요청 상태

제출된 병합 요청 수정하기#

병합 요청을 제출한 후 변경이 필요한 경우:
1.
스프린트 브랜치에서 콘텐츠를 직접 수정하십시오.
2.
변경 사항은 기존 병합 요청과 자동으로 동기화됩니다.
3.
새 요청을 생성할 필요가 없습니다.
4.
수정 사항은 검토 페이지에 표시됩니다.
제출된 병합 요청 수정

병합 요청 거부하기#

병합 요청이 적합하지 않은 경우:
1.
병합 요청 검토 페이지에서 거부를 클릭하십시오.
2.
요청은 닫힘으로 표시됩니다.
3.
변경 후 다시 병합하려면 새 병합 요청을 생성하십시오.
병합 요청 거부
닫힌 요청 상세 정보:
닫힌 병합 요청 상세 정보

자동화 테스트 시나리오 병합하기#

자동화 테스트 시나리오와 엔드포인트는 독립적으로 별도로 병합됩니다. 테스트 시나리오는 전체 병합 페이지 없이 개별적으로 병합해야 합니다.
중요 참고 사항
1.
APIs를 먼저 병합하십시오: 테스트 시나리오를 병합하기 전에 APIs의 리소스를 먼저 병합하십시오. 그렇게 하지 않으면 메인 브랜치의 관련 테스트 시나리오가 비정상적으로 실행될 수 있습니다.
2.
관리자 액세스: 현재는 프로젝트 관리자만 테스트 시나리오를 보호된 메인 브랜치로 병합할 수 있습니다. 테스트 시나리오에 대한 병합 요청 기능은 향후 제공될 예정입니다.
테스트 시나리오 병합:
자동화 테스트의 테스트 시나리오에서 ... 버튼 위에 마우스를 올리면 메인으로 병합 옵션을 확인할 수 있습니다.
테스트 시나리오 병합
테스트 시나리오 병합 팝업에는 다음이 표시됩니다:
정보설명
기본 정보스프린트 브랜치 테스트 시나리오 및 연결된 메인 브랜치 시나리오(있는 경우)입니다.
마지막 실행 결과마지막 수동 실행 결과입니다(요약을 보려면 마우스를 올리십시오). 병합하기 전에 시나리오가 통과하는지 확인하십시오.
병합 작업덮어쓰기(메인에서 포크된 경우) 또는 추가(신규인 경우)입니다.
테스트 시나리오 병합 팝업
Modified at 2026-06-09 08:53:32
Previous
브랜치에서 API 설계하기
Next
스프린트 브랜치 관리
Built with