[BUG&REQUEST] v2文档中存在的错误 和 一点小提议

[Zaitonn]

bug

API 调用｜鉴权 - 获取接口凭证	属性	类型	说明
access_token	string	获取到的凭证。
expires_in	number	凭证有效时间，单位：秒。目前是7200秒之内的值。

• 实际返回中expires_in为string
• 但是按照语义此值应该为number。。为啥要用字符串传数字:(

---

一点提议

• [ ] v2的api支持使用v1的api验证方式（Bot {id}.{token}），方便开发者适配和维护
• [ ] 对于v1的api的返回类型中标出可能为空的属性

• [ ] 统一api的返回格式

  • 无论如何不直接返回空响应body
  • 对于返回类型为数组的api，若数组为空就直接返回空响应body了，个人感觉不够恰当
  • 对于post或put等没有响应的操作，能否考虑返回当前操作的执行状态等
  • 返回的对象从openapi 错误返回的对象继承，方便开发者处理

    
    {
    "code": 10001,
    "message": "", // 错误信息
    "data": null // 返回的数据
    }