説明
OpenAPI 2.0の basePath はAPIの共通パスを表し、指定する場合は / で始める必要があります。省略すると、APIはホストの直下で提供されます。
想定される影響
ツールが誤ったリクエストURLを生成したり、仕様の検証に失敗したりする可能性があります。
対処方法
実際の共通パスを、先頭に / を付けて記述してください。host、basePath、各操作のパスを組み合わせたアドレスが実際のAPIと一致することを確認してください。
例
次の抜粋では、スラッシュで始まらないパスの代わりに /api を共通パスとして指定しています。
変更前
json
{
"swagger": "2.0",
"basePath": "api/incorrect"
}
変更後
json
{
"swagger": "2.0",
"basePath": "/api"
}