Openapi_gh NPM

介绍

fork by https://github.com/chenshuai2144/openapi2typescript，新增了登录凭证参数【authorization】

根据 OpenApi3 文档生成 request 请求代码。

如果你使用 umi ,你可以使用@umijs/plugin-openapi 插件。

使用

npm i --save-dev openapi_gh

在项目根目录新建 openapi.config.ts

const { generateService } = require('openapi_gh');

generateService({
  schemaPath: 'http://petstore.swagger.io/v2/swagger.json',
  serversPath: './servers',
  authorization: 'test',
});

在 package.json 的 script 中添加 api: "openapi": "ts-node openapi.config.ts",

生成 api

npm run openapi

参数

属性	必填	备注	类型	默认值
requestLibPath	否	自定义请求方法路径	string	-
requestOptionsType	否	自定义请求方法 options 参数类型	string	{key: string: any}
requestImportStatement	否	自定义请求方法表达式	string	-
apiPrefix	否	api 的前缀	string	-
serversPath	否	生成的文件夹的路径	string	-
schemaPath	否	Swagger 2.0 或 OpenAPI 3.0 的地址	string	-
projectName	否	项目名称	string	-
authorization	否	登录凭证	string	-
namespace	否	命名空间名称	string	API
mockFolder	否	mock 目录	string	-
enumStyle	否	枚举样式	string-literal \| enum	string-literal
nullable	否	使用 null 代替可选	boolean	false
dataFields	否	response 中数据字段	string[]	-
isCamelCase	否	小驼峰命名文件和请求函数	boolean	true
hook	否	自定义 hook	Custom Hook	-

Custom Hook

属性	类型	说明
afterOpenApiDataInited	(openAPIData: OpenAPIObject) => OpenAPIObject	-
customFunctionName	(data: APIDataType) => string	自定义请求方法函数名称
customTypeName	(data: APIDataType) => string	自定义类型名称
customClassName	(tagName: string) => string	自定义类名
customType	(schemaObject: SchemaObject \| undefined,namespace: string,originGetType:(schemaObject: SchemaObject \| undefined, namespace: string) => string,) => string	自定义获取类型返回非字符串将使用默认方法获取 type
customFileNames	(operationObject: OperationObject,apiPath: string,_apiMethod: string,) => string[]	自定义生成文件名，可返回多个，表示生成多个文件. 返回为空，则使用默认的获取方法获取

@umijs/fabric chalk dayjs glob lodash memoizee mock.js mockjs node-fetch nunjucks openapi3-ts prettier reserved-words rimraf swagger2openapi tiny-pinyin

1.0.5

9 months ago

1.0.4

9 months ago

1.0.3

9 months ago