各位老哥见过这样的后端 API 约定吗

入职一个多月，还在试用期，这周被调到一个新的项目组，说是以后就负责这里的前端了。小组就 1 前端+1 后端+1 产品(负责人，也做后端)，要做一个统计项目。

谈到 API 的时候产品告诉我，他们的 API 会返回下面这种格式，我也需要用这种格式返给后端

{
    'A00001': '...',
    'A00002': '...',
    'B00001': '...',
    'C00001': '...',
    // ...
}

ABC 表示数据层级什么的(这个没听明白，好像在数据库里的表字段也是这样命名的)，编号随着字段增加会一直递增，会给我一张 Excel 表让我去查对应的编码的解释。

问这么做的原因，说是出于什么加密的打算，说反正前端都是要查表填字段的，变量取什么名字又没差。我：？？？？？

当时我就表示无法接受，气氛一度很尴尬，最后也不了了之了。感觉后面再谈这个事情会闹得不愉快。

这让前端怎么搞？我这一年多经验见识少，有没有老哥能跟我讲讲其中的奥义？

其实还有不少坑，比如原型是一份到处截图下来的像剪贴画的 Excel 表格，月底还要上线第一版，感觉是个巨坑。当时面试的时候并不知道要我来做这个，我都没打算做一个人的项目。

公司 100 人左右，不算太小，感觉算技术型公司，但是要看项目组。做 Web 的前端岗位就我跟面试我的小哥（水平不错）两人，这一个多月是在一起做项目的，配合的很不错，前端这块并不是公司的重点。

现在考虑的是，如果是个坑就得跑，但是因为我是 7 月底离职后在家待了 2 个多月，10 月份才开始找工作并入职的，这样简历上是不是没法看了？ 1 年多的前端很多 HR 都直接筛掉了，根本没有面试机会。

坐标厦门，15 毕业，省内 211，工科专业非计算机，毕业后做 2 年 C#开发后转前端做到现在，这是我第一次跳槽，待遇就不要提了，都是泪。

Chingim

2018-12-04 12:07:52 +08:00

无非就是 mapping 谁来做的问题罢了.
这种场景我都是说服后端, 让他们做, 理由:
1. 接口字段应该语义化, 一来方便开发, 需要传什么值一目了然. 二来方便测试, 测试人员抓包的时候如果能一眼看出数据含义, 效率会很高. 不仅仅字段名称语义化, 连字段值也要尽量语言化, 能传 ISO 格式的时间, 就不要传时间戳

2. 如果有多个端(ios/android/其他 web)在消费这个接口, 那么每个端都得做自己做一遍映射, 代码冗余