1.0.0-beta.41 • Published 3 years ago
@pagoda-tools/swagger-ui v1.0.0-beta.41
@pagoda-tools/swagger-ui
安装
# install npm
npm install @pagoda-tools/swagger-ui -S
# install yarn
yarn add @pagoda-tools/swagger-ui -S
文档编写示例
- 根目录新增配置文件
swagger.config.js
import { defineSwaggerConfig } from '@pagoda-tools/swagger-ui';
export default defineSwaggerConfig({
info: {
title: '测试文档标题',
version: '1.0.0',
},
server: [
{
url: 'http://www.xxx.com',
description: '测试环境',
},
],
});
- 在 src 任意目录下新建
xx.dto.ts
,示例代码如下:
import {
defineSwaggerConfig,
defineSwaggerApi,
IsInt,
IsString,
Type,
ValidateNested,
} from '@pagoda-tools/swagger-ui';
class User {
@IsString()
name: string;
}
export class TestInput {
@IsInt()
@JSONSchema({
description: '字段描述',
})
a: number;
@ValidateNested({ each: true })
@Type(() => User)
@JSONSchema({
description: '字段描述',
})
users: User[];
}
export class TestOutput {
@IsInt()
a: number;
}
export default defineSwaggerApi({
method: 'get',
summary: '接口名称',
input: TestInput,
output: TestOutput,
});
- 在
package.json
的scripts
中新增命令
{
"scripts": {
"doc-serve": "pd-swagger-ui serve",
"export-doc-json": "pd-swagger-ui json"
}
}
- 执行
npm run doc-serve
swagger.config.js 配置项
interface SwaggerConfig {
info?: {
// 文档标题
title?: string;
// 文档描述
description?: string;
// 文档版本
version?: string;
};
server?: {
// 接口环境地址
url: string;
// 接口环境地址描述
description?: string;
}[];
}
IsInt
等修饰器参考 class-validator
1.0.0-beta.22
3 years ago
1.0.0-beta.23
3 years ago
1.0.0-beta.20
3 years ago
1.0.0-beta.21
3 years ago
1.0.0-beta.40
3 years ago
1.0.0-beta.41
3 years ago
1.0.0-beta.28
3 years ago
1.0.0-beta.29
3 years ago
1.0.0-beta.26
3 years ago
1.0.0-beta.27
3 years ago
1.0.0-beta.24
3 years ago
1.0.0-beta.25
3 years ago
1.0.0-beta.33
3 years ago
1.0.0-beta.34
3 years ago
1.0.0-beta.31
3 years ago
1.0.0-beta.32
3 years ago
1.0.0-beta.30
3 years ago
1.0.0-beta.19
3 years ago
1.0.0-beta.39
3 years ago
1.0.0-beta.17
3 years ago
1.0.0-beta.18
3 years ago
1.0.0-beta.37
3 years ago
1.0.0-beta.15
3 years ago
1.0.0-beta.38
3 years ago
1.0.0-beta.16
3 years ago
1.0.0-beta.35
3 years ago
1.0.0-beta.13
3 years ago
1.0.0-beta.36
3 years ago
1.0.0-beta.14
3 years ago
1.0.0-beta.12
3 years ago
1.0.0-beta.11
3 years ago
1.0.0-beta.10
3 years ago
1.0.0-beta.9
3 years ago
1.0.0-beta.8
3 years ago
1.0.0-beta.7
3 years ago
1.0.0-beta.6
3 years ago
1.0.0-beta.5
3 years ago
1.0.0-beta.4
3 years ago
1.0.0-beta.3
3 years ago
1.0.0-beta.2
3 years ago
1.0.0-beta.1
3 years ago
1.0.0-beta.0
3 years ago