我有以下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 时出现以下错误:
paths./users.get.responses.403.schema.$ref 处的解析器错误
无法解析引用:尝试解析相对 URL,但没有基本路径。路径:'components.yaml' 基本路径:'未定义'
我在这里缺少什么?