psaren/api-to-interface

api-to-interface

将 yapi 接口数据转换为 typescript interface

install

npm i api-to-interface -g

初始化

ati init 

此命令将创建 ati.config.js 配置文件

// ati.config.js
module.exports = {
  // yapi 项目 url
  url: '',
  // 项目 id
  projectId: '',
  // yapi 项目 token
  token: '',
  // interface 输出目录
  output: '',
  // 项目内的分组 id
  groupId: [],
  // (可选) 自定义 interface name 
  customInterfaceName: (name, type) => {
    if (type === 'req') {
      return `${name}Req`
    } else {
      return `${name}Res`
    }
  }
}

API signature

type CustomInterfaceName = (name: string, type: string, response: any) => string

interface YapiConfig {
  url: string
  projectId: string
  token: string
  output?: string
  groupId?: string[]
  json2TsOptions?: Partial<Options>
  customInterfaceName?: CustomInterfaceName
}

生成 interface

ati run

configs

属性	说明	类型	默认值
url	yapi 项目 url	string
projectId	项目 id	string
token	yapi 项目 token	string
output	interface 输出目录	string
groupId	项目内的分组 id	string[]
customInterfaceName	自定义interface name	CustomInterfaceName

support customInterfaceName start at V1.0.6!