和主管为一个接口输出真吵了一天,搞得都想离职,求怎么破

2019-03-19 11:10:18 +08:00
 HackerPainter

主管想用的接口输出

{
  "status" : "错误码",
  "error" : "错误消息",
  ......
}

楼主想用的接口输出

{
  "errorCode": "错误码",
  "errorMsg" : "错误消息",
  ......
}

我在想一个接口至于争吵一天吗?最后我妥协了,现在感觉好想离职,请问怎么破

37437 次点击
所在节点    程序员
436 条回复
newmind
2019-03-19 11:55:58 +08:00
同楼上,用的 code,msg,data,简洁明了,不过楼主和主管的都没问题啊
southsala
2019-03-19 11:56:20 +08:00
对接过两位数公司的接口,基本每家都不一样,听你主管的吧,除非你当主管,计较这个没有意义。我这样不接受任何反驳。
{
"success": false,
"msg": "系统错误",
"code": 1002
}
kamal
2019-03-19 11:56:53 +08:00
@gamexg #68
{
"status" : "错误码",
"error" : "错误消息",
"errorCode": "错误码",
"errorMsg" : "错误消息",
"errorcode": "错误码",
"errormsg" : "错误消息",
data:{}
}
shiguiyou
2019-03-19 11:57:05 +08:00
两个人都有问题。我要是主管,直接回一句,爱写写,不爱写我重新找个人。如果我是 lz,直接写,哪来那么多问题。
sanqian
2019-03-19 11:58:13 +08:00
- -我这用这个
{
"code": "错误码",
"msg": "错误消息",
}
index90
2019-03-19 11:58:27 +08:00
code 或者 number,是用来给研发用的,根据错误码反查常量表,再搜索到错误代码行。
msg 或者 errorMsg,都是用来给调用方看的,例如给前端研发看,好让他们在不看代码的时候知道是什么错,例如少传了参数什么的,msg 我一般在接口层编写,与业务有关。

如果是我设计,就是 code 和 message 两个字段,这样定义使用场景更广。和你主管的设计差不多,正如楼上有人说了,如果正常返回,难道也要用 errorMsg ?不知道楼主坚持自己的设计是出于什么原因。

第二,因为这些小事争吵,技术人员里面很常见,这也是我很讨厌做技术的原因之一,总是为这些无聊的事情争吵。例如争论哪个语言好,都是屁股决定脑袋,研发人员更甚,研发人员的脑袋基本是贴在了自己的屁股上,写个代码还要写出优越感。
reus
2019-03-19 11:59:06 +08:00
根本不是技术问题,而是权力斗争,类似皇权和相权的斗争。技术来看,两种都没什么区别。但是你可能觉得主管插手这种具体命名,不给你控制权,所以不爽吧,谁知道以后还会插手哪些事情呢。主管可能也觉得连命名一个 api 返回字段的权力都没有,很没面子吧。他不插手,或者你没所谓,就平安无事的。

赶紧走啊,连这点事情都能吵起来,遇到更大的设计选择,还不得闹翻天。

主管要么定好规范,大家遵守,要么不定规范,让大家自由发挥,自己不定规范,要靠吵架,无能。当然你这种死杠最后还妥协的,除了浪费大家的工作时间也没有其他用途了。
sazn
2019-03-19 11:59:12 +08:00
主管很有想法啊
无论表达意思的广度,还是 json 长度,都是主管的占优耶
dark3212
2019-03-19 12:01:26 +08:00
个人猜想:
一开始是因为懒得改和强迫症吵起来了,双方互不妥协,越吵越厉害。
到后面已经不是懒得改和强迫症的问题了,已经是面子问题,但是显然你没你主管面子大,你感觉受到了侮辱,所以想离职。
所以这种小破事一开始就改了就行了,不就啥事没有了吗?
lihongjie0209
2019-03-19 12:01:51 +08:00
闲的蛋疼
method
2019-03-19 12:02:23 +08:00
主管的设计没啥问题啊
lzhCoooder
2019-03-19 12:03:07 +08:00
{
"error_code": "错误码",
"error_msg" : "错误消息",
......
}
fox0001
2019-03-19 12:08:11 +08:00
楼上的真闲…这种情况应该找架构师决定
CSwater
2019-03-19 12:08:27 +08:00
@keepeye #28 反驳!为啥不用 RESTful 呢?
zwh2698
2019-03-19 12:09:06 +08:00
赞成你主管,你的定义没有弹性。数据结构设计需要保持一点弹性。这个就是经验。这种问题没有对错,不是一加一等于 3 就错了,你的可能也满足现状。但是弹性粒度不够。如果你一味强调自己的反而丢失聆听的能力。你说呢
watzds
2019-03-19 12:09:14 +08:00
主管的好
ranwu
2019-03-19 12:09:19 +08:00
看一下 github 的 api 是怎么设计的
whoisghost
2019-03-19 12:09:26 +08:00
根据你后面的评论,从技术上来说。你的接口是对的。从人方面来说,如果你一开始把情况说清楚,就没那么多人在技术上批判你了,你表达能力有点差。

你主管有点伪洁癖,为简洁而简洁。
fox0001
2019-03-19 12:09:54 +08:00
其实,HTTP 标准也是用 status 代表状态码 /错误码
yingfengi
2019-03-19 12:11:43 +08:00
憋吵了,听我的,输出√和❎

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

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

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

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

© 2021 V2EX