前端对接这样的 API，各位老哥有什么建议吗

先说一下项目背景

互联网公司，做自己的产品，全新的统计项目。3 人团队，1 产品 + 1 后端 + 1 前端。

项目负责人(产品)是从银行出来的，和后端一起设计、维护数据库，制定了前后端 API。

上个月就 API 字段命名方式我提过一个问题( t/514030)

后续和负责人沟通的结果是：API 和字段名没有改变的可能，没有、也不会提供什么字段表，不好做就自己想办法。

当时大家建议去做 mapping，因为各种原因，目前我只把这些 code 全部变量化，加上 JSDoc，并且所有跟这些 code 相关的代码都单独用TypeScript来写。

目前页面已经写完了，用的 Vue + echarts，数据目前都是我本地 Mock 的，因为 API 给的晚，Mock 的格式没有和实际完全对应。

API 示例

// request params // 请求 A 表这些字段，post to api/a { "date_start": "2019-1-1", "date_end": "2019-1-3", "id": "v2ex", "cols": "A0001,A0002,A0003,A0004..." } // B 表，post to api/b { "date_start": "2019-1-1", "date_end": "2019-1-3", "id": "v2ex", "cols": "A0001,A0002,B0001,B0002..." // ... } // ... // 前端请求哪些字段，后端就只返回这些字段的数据 // 部分字段通用 // 返回数据格式区分宽表、窄表 // 宽表返回格式 { "A0001": "2019-1-1", // date，通用 "A0002": "v2ex", // id，通用 "A0003": "1", "A0004": "1", // ... } // 窄表返回格式 { "A0001": "2019-1-1", "A0002": "v2ex", "INDEXID": "F0001" "INDEXV": "1" }, { "A0001": "2019-1-1", "A0002": "v2ex", "INDEXID": "F0002" "INDEXV": "1" }, // ... 

• A0001, A0002 这些都是实际的字段名，也是数据库的列名，有一张 Excel 的对照表可以查字段的含义。前端需要哪些列的值，就把相应列的 code 作为请求的参数传给后台。

• 后台返回格式不一致(宽表、窄表两套格式)。

• 不同的首字母表示不同的表，对应的字段需要 post 到不同的 API。比如 AXXXX，BXXXX 要分别给到api/a, api/b两个接口。

• 一项业务存在使用多张表的数据的情况，前端需要自己来做数据聚合。

• 根据业务需要，前端要对部分返回结果做过滤 /分类 /计算。

• 同一项指标的不同选项(比如留存，有 3 日、7 日、14 日等选项可选)会对应不同的 code，前端需要区分发送。目前我用表驱动法维护了很多这类的 mapping。

考虑的问题

• 业务逻辑的维护

目前我针对每一项具体业务写了 Adapter ，用来管理要发送的数据列，以及返回数据的转换处理工作 。

感觉项目中用的最多的就是 Array.map, Array.reduce 这两个方法。。UI 的文本、各种选项下对应的请求字段、各种图表数据都跟那些 code 做了对应。很怕以后维护的时候看不懂。

• Ajax 请求数量

目前各个业务模块的请求是单独发送的(一个页面多个模块)，一次刷新 devtool 里面各种 abcdef 的请求，如果存在跨表的业务(Promise.all 等待)就有更多。等浏览器排队走完。

目前后台数据还不完善，很多返回值都是 null，速度还无法评估。

请问前端目前这样处理有没有什么问题？听说过 GraphQL， 不知道是不是可以解决这类问题？不过估计也没有用的机会。

还想问问各位老哥，前端对接这样的接口，有没有什么好的做法？有没有什么坑是需要注意的？

另外，因为以前只做过后端给大接口(聚合了目标业务需要的所有数据)的项目，想问问这样的接口算不算 RESTful ？ 后端 API 这样设计，是不是后续只要负责往数据库里面填数据就可以了？

试用期还有一个月，做的好心累，感觉自己好菜