일반 설정#
대상 및 목적지#
| 옵션 | 설명 |
|---|
| Basic Auth | 사용자 이름/비밀번호 인증이 필요한 URL 가져오기에 사용됩니다. |
| 대상 브랜치 | 데이터를 가져올 특정 브랜치를 선택합니다(기본값은 main). |
| 가져올 위치 | 기존 폴더/모듈로 가져오거나 새로 만들도록 선택합니다. |
| 케이스 자동 생성 | 활성화하면 사양에 예제가 없는 경우 Apidog가 자동으로 "Success" 테스트 케이스를 생성합니다. |
환경 가져오기#
OpenAPI/Swagger 파일에 여러 서버가 정의되어 있는 경우, 서버를 환경으로 가져오기를 활성화하여 Apidog에서 일치하는 환경을 자동으로 생성할 수 있습니다.보안 및 이름 지정#
보안 스키마#
OpenAPI의 securitySchemes가 처리되는 방식을 제어합니다.전역 인증: 사양의 전역 보안을 Apidog의 루트 폴더 인증에 매핑합니다.
정의되지 않은 인증: 특정 보안이 없는 엔드포인트에 대한 동작을 결정합니다(예: "상위 항목에서 상속" 또는 "인증 없음").
엔드포인트 이름 지정#
엔드포인트에 설명적인 Summary 필드가 없는 경우, 이름에 사용할 대체 출처를 선택할 수 있습니다.충돌 해결#
가져온 데이터가 기존 데이터와 일치하는 경우(Method 및 Path 기준), 다음 규칙을 사용하여 결과를 결정합니다.엔드포인트 충돌#
| 전략 | 동작 |
|---|
| 덮어쓰기 | 이전 엔드포인트를 새 데이터로 완전히 대체합니다. |
| 둘 다 유지 | 중복 항목을 생성하여 이전 항목과 새 항목이 나란히 존재하도록 합니다. |
| 무시 | 새 엔드포인트를 건너뛰고 이전 엔드포인트를 변경 없이 유지합니다. |
| 병합 | 스마트 업데이트: 정의를 업데이트하면서 이름, 목 규칙 및 설명과 같은 수동 변경 사항을 유지합니다. |
| 선택 항목 덮어쓰기 | 선택한 특정 필드만 업데이트하고 다른 필드는 유지합니다. |
기타 리소스(스키마 / 문서)#
Markdown 문서, 스키마 및 컴포넌트에는 유사한 덮어쓰기와 병합 옵션이 적용됩니다.고급 동기화 로직#
폴더 동기화#
가져온 엔드포인트가 프로젝트의 기존 엔드포인트와 일치하지만 폴더 위치가 다른 경우:기존 폴더 유지: 가져온 파일의 폴더 경로를 무시합니다. 엔드포인트는 Apidog의 현재 폴더에 그대로 유지됩니다.
엔드포인트 폴더 업데이트: 엔드포인트를 가져온 파일에 정의된 폴더 구조로 이동합니다.
리소스 정리#
프로젝트에는 존재했지만 새 가져오기 파일에는 누락된 리소스에 어떤 작업을 수행할지 결정합니다.삭제하지 않음(안전): 프로젝트의 고아 리소스를 유지합니다.
삭제(동기화): 새 파일에 없는 모든 리소스를 제거합니다. 사양의 정확한 미러를 유지하려면 주의해서 사용하십시오.
Modified at 2026-06-09 08:53:32
