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의 기본 개념
    • 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로 마이그레이션

예약 가져오기(데이터 소스 바인딩)

예약 가져오기는 정기적인 간격으로 외부 소스의 API 명세를 Apidog로 자동 동기화합니다. 이 기능은 외부 시스템(예: Git 저장소 또는 Swagger 엔드포인트)에서 API 명세를 유지 관리하지만, 수동으로 다시 가져오지 않고도 Apidog의 강력한 디버깅 및 테스트 기능을 활용하려는 팀에 적합합니다.
예약 가져오기를 사용하면 다음을 수행할 수 있습니다.
선호하는 버전 관리 시스템에서 API 명세의 단일 진실 공급원을 유지 관리합니다.
사용자 지정 가능한 간격(30분마다, 매시간, 매일 등)으로 변경 사항을 자동 동기화합니다.
GitHub, GitLab, Azure DevOps 및 직접 URL을 포함한 여러 소스에서 가져오기를 수행합니다.
수동 개입 없이 최신 API 변경 사항으로 팀의 정렬 상태를 유지합니다.

구성 방법#

1
설정으로 이동
Settings -> Import Data -> Scheduled Import (Bind Data Sources)로 이동하십시오.
2
데이터 소스 생성
구성을 추가하려면 "New"를 클릭하십시오.
3
설정 구성
데이터 소스 세부 정보(URL, 빈도 등)를 입력하십시오. Git 저장소 바인딩에 대한 자세한 내용은 다음 섹션을 참조하십시오.
4
저장 및 활성화
Save를 클릭하십시오. 이제 가져오기가 빈도 설정에 따라 자동으로 실행됩니다.
Apidog는 단일 프로젝트 내에서 여러 데이터 소스를 생성하는 것을 지원하며, 각 데이터 소스는 서로 다른 폴더로 동기화 및 가져오기를 수행합니다.

Git 저장소 바인딩#

Apidog는 다음의 Git 저장소 바인딩을 지원합니다.
Github
GitLab 및
Azure DevOps
Git 저장소를 바인딩하려면 다음 단계를 따르십시오.
1
Bind Data Sources 대화 상자에서 Git Repository 옵션을 선택하고 저장소 연결을 생성하십시오.
이미지.png
2
선호하는 버전 관리 플랫폼을 선택한 후, 안내에 따라 Apidog가 저장소에 접근할 수 있도록 권한을 부여하십시오.
3
Apidog로 다시 리디렉션되면 Organization 및 Repository를 선택한 다음 Save를 클릭하십시오.
이미지.png
4
마지막으로 Branch와 OpenAPI Spec 파일을 선택하고 바인딩 프로세스를 완료하십시오.

구성 참조#

설정설명
가져오기 빈도Apidog가 데이터 소스에서 업데이트를 확인하고 가져오는 빈도입니다. 옵션에는 30분마다, 매시간, 매일 또는 사용자 지정 간격이 포함됩니다.
소스 형식API 파일의 명세 형식입니다. 지원 형식: OpenAPI(Swagger), ApiDoc 또는 Apidog 네이티브 형식입니다.
소스 URLAPI 명세 파일에 대한 직접 HTTP(S) 링크입니다. 예: https://petstore.swagger.io/v2/swagger.json. 공개적으로 접근 가능하거나 Basic Auth로 보호되어 있어야 합니다.
실행 위치가져오기 작업의 실행 환경입니다. Local Client(앱이 열려 있을 때 실행) 또는 Runner(자체 호스팅 서버에서 24/7 실행)를 선택하십시오.
Basic auth소스 URL이 HTTP Basic Authentication으로 보호되는 경우 사용자 이름 및 비밀번호 자격 증명입니다. 공개 URL의 경우 비워 두십시오.
더 많은 가져오기 옵션은 가져오기 옵션을 참조하십시오.

실행 모드#

예약 가져오기는 가져오기 명령을 실행하기 위한 실행 환경이 필요합니다. 워크플로에 가장 적합한 모드를 선택하십시오.

1. Local Client(기본값)#

가져오기는 Apidog 데스크톱 앱이 열려 있을 때만 실행됩니다.
요구 사항: 쓰기 권한이 있는 상태로 프로젝트를 열어 두어야 합니다.
제한 사항: 앱 또는 프로젝트를 닫으면 다시 열 때까지 업데이트가 일시 중지됩니다.
네트워크: 컴퓨터에서 접근할 수 있는 경우 내부 네트워크 URL에 접근할 수 있습니다.
Apidog Web App에서 프로젝트를 여는 경우에도 예약 가져오기가 트리거됩니다. 하지만 브라우저 보안 제한으로 인해 Web App이 내부 네트워크 URL에 접근하지 못할 수 있습니다.

2. 자체 호스팅 Runner#

가져오기는 Apidog Runner를 배포한 서버에서 실행됩니다.
이점: 온라인 상태 여부와 관계없이 24/7 실행됩니다.
사용 사례: 수동 개입 없이 일관된 업데이트가 필요한 팀에 가장 적합합니다.
자체 호스팅 Runner 배포에 대해 자세히 알아보십시오.

고급: 스프린트 브랜치로 가져오기#

가져오기를 특정 스프린트 브랜치로 지정할 수 있습니다. 기본적으로 데이터는 Main Branch로 가져옵니다.
자세한 워크플로는 스프린트 브랜치로 데이터 가져오기를 참조하십시오.
Modified at 2026-06-09 08:53:32
Previous
수동 가져오기
Next
가져오기 옵션
Built with