설명
OpenAPI 2.0의 basePath는 API의 공통 경로를 나타내며, 지정할 때는 /로 시작해야 합니다. 생략하면 호스트 바로 아래에서 API를 제공합니다.
잠재적 영향
도구가 잘못된 요청 URL을 만들거나 명세 검증에 실패할 수 있습니다.
해결 방법
실제 공통 경로를 /로 시작하도록 작성하세요. host, basePath, 개별 작업 경로를 조합한 주소가 실제 API와 일치하는지 확인하세요.
예시
다음 발췌 예시는 슬래시가 없는 경로 대신 /api를 공통 경로로 지정합니다.
변경 전
json
{
"swagger": "2.0",
"basePath": "api/incorrect"
}
변경 후
json
{
"swagger": "2.0",
"basePath": "/api"
}