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

2018-12-04 00:57:52 +08:00
 doommm

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

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

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

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

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

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

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

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

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

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

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

10224 次点击
所在节点    程序员
101 条回复
doommm
2018-12-04 09:23:15 +08:00
@VoidChen 移动互联网企业,自己的项目
ifoto
2018-12-04 09:23:30 +08:00
为同在鹭岛的你的感慨一下。厦门这种坑逼还是很多的
doommm
2018-12-04 09:25:09 +08:00
@lsongiu 是 json,我写的是 js 的格式,举个例子而已
strive
2018-12-04 09:26:38 +08:00
遇到过设计成字段 1 字段 2 字段 3 字段 4,当时就一脸懵逼
doommm
2018-12-04 09:27:25 +08:00
@Norie 做的是公司自己的项目,算是旧平台重做吧
ilaipi
2018-12-04 09:28:57 +08:00
我是后端出身的,一样看不惯这样的后端。前端代码现在如果上线要保密啥的至少要 ugly 一下吧。。。靠这样的编码变量名,真是画(xian)蛇(de)添(dan)足(teng)。不知道后端是用的什么语言,现在大部分语言应该都可以前端数据直接 mapping 到 model 了吧,这样编码一下,这个 mapping 不得加一层了?真是 F***
shyangs
2018-12-04 09:41:19 +08:00
ZF 标准
Sapp
2018-12-04 09:54:45 +08:00
如果是为了保密什么的,你们后端是个傻逼无疑,这保密个锤子?
如果仅仅是格式不符合前端调用,那简直太正常了,后端一贯的德行,自己撸着舒服就行,甚至有后端从库里取出来什么就给你什么(一串字符串转都不愿意转...),碰上一个好的后端简直太艰难,我现在都是自己转
xiaozizayang
2018-12-04 10:02:40 +08:00
各个公司由于历史原因各种规定 估计你组长也不知道为什么是这个样子哈哈 btw 我也在厦门 哈哈
guoyuchuan
2018-12-04 10:06:48 +08:00
表示看不懂
notreami
2018-12-04 10:19:51 +08:00
拿着白面的钱系列,数据 key 真的重要嘛??系统架构设计、中间件、持续交付、监控容灾抗压等等才是关键吧。
这种格式,说白了,就是之前种种原因( zf 要求、大佬一游等)设计成这样了。
然后让你改,你能怎么改呢?全盘推到重做?针对自己这块做 key 映射,然后引入一些新 key 让大家学习?
在不放弃的原则下,那肯定是忽略这块,然后看看业务流程、技术栈、维护的服务系统设计、整体系统架构等等有木有坑,这些坑感觉太大,就可以名正言顺的下一家了。
stzz
2018-12-04 10:25:52 +08:00
你如果看不惯就跑吧,要不你来重构数据结构?
codespots
2018-12-04 10:29:50 +08:00
@annielong 这算少见多怪?隐藏数据库字段,要 AS 干什么吃的
reself
2018-12-04 10:31:16 +08:00
@doommm 加密个铲铲,估计他自己都不懂这么做的缘由,只是照搬别人的规范而已。
这么做完全是为了维护性,代价是需要建额外的字段映射表。如果表很少,这么做确实有点多余。但是如果表很多,字段上万,这么做非常有必要。
duan602728596
2018-12-04 10:35:08 +08:00
有毛线用,扒过一堆接口的人表示,字段这东西猜都能猜出来
learnshare
2018-12-04 10:35:27 +08:00
这种加密方式的好处是自己人看起来麻烦
doommm
2018-12-04 10:42:21 +08:00
@reself 上万个的字段都选择这么直接返回给前端的话,前端真的会狗带…
snw
2018-12-04 10:44:26 +08:00
ZF 标准只看到过取值有固定编码,没见过字段名用固定编码的。印象中 ZF 项目字段名不都是拼音首字母缩写吗?
http://www.gov.cn/gongbao/content/2017/content_5165785.htm
visonme
2018-12-04 10:45:14 +08:00
见没见过还真不重要
API 约定,不说不同的公司,有自己的一套甚至于几套规范,就是同家公司不同组都存在很大的差异。
重要的是,这些约定是明确,有效,可执行的~
snw
2018-12-04 10:46:15 +08:00
你把那张 excel 表做个映射表,然后自己管自己用语义化的变量名,和后端通讯时 map 一下就行

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/514030

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX