请问如何自定义swagger自动生成的Apis方法

[seepine]

目前遇到两个问题，是否能实现呢

const res = await Apis.user.add({
  data: {
    username: 'Bob'
  }
})

// res = { code: number; data: any; msg?: string}

1. 一个请求时的自定义

因为我方系统统一了规范，例如post只会有body，每次都要套一个data过于重复

2. 返回的结果

目前结果都统一了结构，直接在responsed拦截了异常的情况，希望返回时会直接拿结果中的data

{ code: number; data: any; msg?: string}

[MeetinaXD]

对于1，不建议，还有很多与method相关的参数。退一步说，假如实现了你提出的需求，这时如果想要指定 method.cacheFor 就比较麻烦了

对于2，可以在 alova.config.ts 中通过 handleApi 来实现自定义 response 类型。但这样需要保证接口返回的数据类型全为 json，如果后期添加一个例如返回 Multipart 数据的接口，这个方案就要打补丁。

我个人会习惯将所有的 method 重新用函数包装一次，这样恰好能实现你提到的需求：

async function addUser(username: string) {
  return Apis.user.add({
    data: {
      username
    },
    transform: data => data.data
  })
}

这样的好处是不失去灵活性。

[MeetinaXD]

补充一下，对于 1 目前还不支持这样的自定义

[seepine]

对于1，包括2再封装一层，按目前很多后端的规范都是 {code data msg}，还是需要写一堆的 { data: {} } 和 res.data ，所以如果都能自定义的话便利性会大大提升很多，这样的话通过swagger自动生成接口方法，就跟普通调用方法一样，会非常方便，对前端来说更无感了

而对于非json，如果能自定义应该也可以实现，例如判断contentType是json，入参就给data，对于get之类，入参就给paramQuery之类，不过对于业务系统，大部分接口还是都是json，或者特殊接口不使用swagger生成的，而是直接使用method发起请求也可以，因为毕竟是少数

[JOU-amjs]

{code data msg}可以在全局响应里统一拦截转换，类型就在handleApi转换，如果有特殊接口比如返回二进制的，可以通过元数据标注。并特殊处理