我有以下 api 文档:
swagger: "3.0"
info:
version: 0.0.1
title: Test API
paths:
/users:
get:
summary: Get all registered users
produces:
- application/json
responses:
200:
description: Users successfully returned
403:
description: User not authorised to call this API
schema:
$ref: 'components.yaml#/components/schemas/AuthError'
其中 AuthError 架构在名为 components.yaml 的单独 yaml 文件中定义:
components:
schemas:
AuthError:
type: object
properties:
error:
type: sting
description: Error message
和 Swagger 配置:
const swaggerDefinition = {
info: {
title: 'FlexiWAN REST API documentation',
version: '1.0.0',
description: 'This is the REST API for FlexiWAN management',
},
components: {},
host: 'local.flexiwan.com:3443',
basePath: '/api',
securityDefinitions: {
JWT: {
type: 'apiKey',
in: 'header',
name: 'Authorization',
description: "",
}
}
};
const options = {
swaggerDefinition,
apis: ['./swagger/**/*.yaml'],
};
const swaggerSpec = swaggerJSDoc(options);
app.use('/docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec));
但是当我尝试访问 Swagger UI 时,出现以下错误:
路径解析器错误。/users.get.responses.403.schema.$ref 无法解析引用:尝试解析相对 URL,但没有 basePath。路径:'components.yaml' 基本路径:'未定义'
我在这里想念什么?