Apidog 프로젝트에서는 모듈을 사용하여 엔드포인트를 구성할 수 있습니다. 모듈은 기술 아키텍처의 "서비스"와 유사하며, 특히 마이크로서비스 기반 시스템에서 엔드포인트를 보다 효율적으로 관리하고 표시할 수 있도록 설계되었습니다. 각 모듈에는 관련 엔드포인트, 컴포넌트(예: 스키마, 응답, 보안 스키마), 그리고 Base URL(각 환경당 하나)이 포함됩니다.각 모듈은 완전하고 독립적인 Swagger/OpenAPI 사양 파일에 해당합니다.모듈을 사용해야 하는 경우#
다음과 같은 경우 모듈을 사용하여 엔드포인트를 구성하십시오.긴밀하게 관련된 서비스: 예를 들어 AI 프로젝트에서 텍스트 생성 엔드포인트용 모듈, 이미지 생성 엔드포인트용 모듈, 음성 엔드포인트용 모듈을 각각 둘 수 있습니다.
마이크로서비스: 예를 들어 전자상거래 프로젝트에서는 인증, 주문, 상품 서비스를 둘 수 있습니다.
여러 API 버전: 예를 들어 프로젝트가 Legacy, LTS, Latest와 같이 서로 다른 API 버전을 외부 사용자에게 제공할 수 있습니다.
모듈 생성하기#
1
프로젝트에서 폴더 트리 상단에 마우스를 올리고
+ 버튼을 클릭하십시오. 드롭다운 메뉴에서
New Module을 선택하십시오.
2
모듈 이름을 입력하고
Save를 클릭하십시오. 새 모듈이 폴더 트리에 표시됩니다. 모듈을 클릭하면 다음을 포함한 세부 정보를 확인할 수 있습니다.
엔드포인트 케이스 및 테스트 시나리오의 커버리지
모듈 변수 – 환경 변수와 유사하지만, 이 모듈의 엔드포인트 요청 내에서만 접근할 수 있습니다. 각 모듈의 Base URL 설정하기#
모듈이 생성되면 환경 관리 페이지에 자동으로 표시됩니다. 새로 추가된 모듈 내에서 각 환경에 대한 Base URL을 지정할 수 있습니다.요청 시 올바른 Base URL 사용하기#
기본적으로 각 모듈의 엔드포인트 요청은 현재 환경에서 해당 모듈에 정의된 Base URL을 엔드포인트 경로와 결합하여 자동으로 사용합니다. 한 모듈의 엔드포인트는 다른 모듈의 Base URL을 사용하여 요청을 보낼 수 없습니다.단일 모듈에 여러 서비스(여러 Base URL)가 포함된 경우, 모듈 내 폴더 또는 엔드포인트 수준에서 사용할 Base URL을 수동으로 지정할 수 있습니다.그러나 이 방식은 Apidog의 이전 사용 패턴에 해당하며, 버전 2.7.16부터는 권장되지 않습니다. 대신 서비스를 별도의 모듈로 분리하고, 각 모듈에 자체 Base URL을 두는 방식을 권장합니다. Modified at 2026-06-09 08:53:32
