接口优化，好的接口对接办法？

Question

在项目开发时会对接很多接口，每个接口会对应很多的属性和值，但是实际上我们并不需要部分值，但是对接的时候往往会由于其中几个属性值对接不上报错，这个时候很耗时间，有没有提高效率办法呢？或者一般都有什么高效对接接口的办法呢？

Answer 1

不想长篇大论了，只说两点：

1. 任何接口都应该自注释，或者有明确查查询的文档
2. 我们写程序的时候，函数就是一种最常见的接口形式。其他接口，包括 HTTP API 接口等，都可以参考函数的语法规范。比如重载/函数签名/可选参数/默认参数。其中，默认参数（也就是某参数缺少时接口内部实现会给默认值）是一种比较好的设计。另外，对于必不可少的参数缺失的情况，很显然在接口内部实现中应该明确报错。

Answer 2

后端 swagger 生成 js/ts 接口层代码,给前端用;
就算不生成代码至起码生成文档.