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

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 2077 天前的主题，其中的信息可能已经有所发展或是发生改变。

主管想用的接口输出

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

楼主想用的接口输出

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

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

第 1 条附言 · 2019-03-20 21:47:08 +08:00

首先非常感谢各位社友的回复和讨论，在看各位社友的评论中学到了很多东西，果然三人行必有我师焉！

社区有些社友可能认为这种接口争吵没啥意义，随便定义一个就行，但如果这个接口被几千人使用甚至被几万人使用，那就得对这个接口好好设计了。如果连自己都对自己提供的接口不保持敬畏，那就别指望用户对你提供的接口保持敬畏，对于用户的抱怨牢骚那只能全部接下。过去几年里很多用户对我们提供的接口出现过各种各样的抱怨（每个用户都有一套自己心目中的接口，就像社区内留言出现很多接口定义），如果接口提供方的接口与接口使用方心目中的接口不一样就会出现或多或少有抱怨和吐槽。为了尽量让用户用的爽，减少用户的抱怨，所以就和主管对接口进行了争吵（善意的争吵），至于想离职是其它方面的原因；
有些社友可能认为和主管争吵不太好，主管想做成什么样自己就做成什么样。但你真认为这种状态好吗？即使你照做了，你觉得主管认可你吗？在互联网环境下，得多与主管、同事讨论讨论问题，有些难解的问题就是在讨论中产出解决方案的。过去几年和主管同事争吵过无数次甚至拍桌子，差点打起来，但这种都是idea的碰撞，只有碰撞中才能产出好的idea，其实碰撞完后同事主管都会私下交流这个都是各自想法，不代表其他含义，不要往心里去。对于主管要你做啥你就做啥，那主管招你有何用，主管可以招任何一个人来替换你，这样你的自身竞争力在哪里。一个程序员要往高处发展，要学会自己去发现问题去解决问题，而不是等待主管安排问题，比如主管交给你一个手工线上部署任务（需要经常部署），结果你每次都可以手工无故障的部署完成，但这种结果是主管希望的吗，主管再找一个人也可以无故障的手工部署，但如果你把手工线上部署做成自动化工具一键部署，可以节约时间且无风险，这样在主管看来你就是不可替代，能自己对问题提出解决方案；
程序之美应该包含编程之美、接口之美和测试之美。如果有一段程序编程无规范、接口随便定义，无单测和功能测试，让你去接手这段代码，你会怎么想？所以还是对接口保持敬畏之心，多花点时间定义接口，少花点时间答疑和听用户的抱怨；

下面各出了很多社友的接口定义，可以供借鉴，排名不分先后，可以投票😄

{
    "code": "错误码",
    "message": "错误消息"
}

{
    "errno" : "错误码"，
    "message" : "错误消息"
}

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

{
    "status": "错误码",
    "msg": "错误消息"
}

{
    "errKey": "错误码",
    "errMsg": "错误消息"
}

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

{
    "statusCode": "错误码",
    "statusMsg": "错误消息"
}

{
    "error_code": "错误码",
    "error_msg": "错误消息"
}

错误

接口

输出

离职

436 条回复 • 2020-12-01 11:05:06 +08:00

1 2 3 4 5

❮

❯

301

XuanYuan

2019-03-19 19:15:50 +08:00

@yiyi11 #107 你这个不全，完整版应该是这样：

喜欢就买，不行就分，多喝开水，重启试试。

302

lincanbin

2019-03-19 19:19:40 +08:00

还是工作不饱和

303

jxgccaaron

2019-03-19 19:21:59 +08:00 via iPhone

{ "errors":"错误消息";}
就这样，完了
code 按 restful 来

304

mostkia

2019-03-19 19:23:33 +08:00

{"code":"200","msg":"........",......}这样可能比较好
一般没必要强调错误参数，返回的什么可能性都有，唯独错误率应该是低的，这是上线的接口的基本功。
所以在很少有错误发生的情况下，为其专门准备一个返回值位置，可能就有些多余，而且也不能从中反推出其他的可能状态，因为总会有其它的状态出现。
还有啊，每个人的想法都是不同的，在公司里面的话，就不能意气用事了，主管怎么说你就怎么做呗。做出来的东西又不是你自己的。不必纠结那么多，大家都是混口饭吃，都留一些情面嘛，好说话一些。

305

srx1982

2019-03-19 19:27:57 +08:00

code, msg 就完了，越少越好
这个真的不值得吵

306

srx1982

2019-03-19 19:28:50 +08:00

@fox0001 通用的 404 之类的还好说，有的时候根本不够用或者找不到合适的，还是要加个 status 之类的字段来判断到底什么错

307

zhuchaowe

2019-03-19 19:32:38 +08:00 via iPhone

@keepeye 看了一圈这个方案我最喜欢其他方案看着脑阔疼

308

fngtz

2019-03-19 19:33:52 +08:00 via iPhone

@reid2017 一毛一样+1，

309

psj1105

2019-03-19 19:40:34 +08:00

这个话题唯一有点价值的就是 V 友们互（各）相（自）学（站）习（队）了

310

liubaicai

2019-03-19 20:01:32 +08:00 via Android

吵架算什么，有本事去尬舞啊

311

oxygenliu

2019-03-19 20:09:15 +08:00 via iPhone

这也能吵？

312

Enochyun

2019-03-19 20:11:15 +08:00

为这点事情离职不值得

313

simonv3ex

2019-03-19 20:27:33 +08:00

我听说过有公司吵架的罚 2 个人牵手一下午的，好像在 b 站上看到的来着[滑稽]

314

zhuzhibin

2019-03-19 20:30:24 +08:00 via iPhone

我更想听听楼主以及主管这样设计的各自的理由是什么？？？

315

ZehaiZhang

2019-03-19 20:32:26 +08:00

？？？ 315 楼了，所以为啥吵架？

316

pinews

2019-03-19 20:53:30 +08:00

在执行成功的时候，楼主的方式缺陷很大，具体事情具体分析，如果不去分析的话，主管的方案更具有普遍性

317

pinews

2019-03-19 21:05:15 +08:00

@HackerPainter
主管的方案里 status 只有两种状态，成功和失败，失败了就提示 errmsg 的内容，并不区分具体错误码。
错误码要来干什么，第一要准确定义错误，防止 msg 歧义，第二归类，错误码很多，第三，程序自动识别。
你都没说问题的背景是什么，不知道怎么评价。

318

exip

2019-03-19 21:09:43 +08:00 via Android

这个帖子囊括了一天的笑点.哈哈哈

319

Gota

2019-03-19 21:11:47 +08:00

比较喜欢 GraphQL 的返回格式:

``` json
{
"data": { ... },
"errors": [ ... ],
"extensions": { ... }
}
```

320

billlee

2019-03-19 21:29:50 +08:00

@gtanyin https://linux.die.net/man/1/mesg
类色的还有 creat

321

tourist2018

2019-03-19 21:32:07 +08:00

看不出这俩有啥区别，命名而已，要是我和别人对接接口，只要数据格式规定好，别的怎样我都没问题

这也能炒一天感情公司找你上班这么浪费时间的？

322

luckyswag

2019-03-19 21:37:19 +08:00

同情主管

323

sorshion

2019-03-19 21:39:45 +08:00

你们就没考虑到正常业务也需要 message 的嘛
{
status:true/false, // true 为正确业务，false 为错误业务
code: 1000,// 编码
msg: '' , // 正确时或错误时用户提示信息,与 code 对应，方便做文案映射
data:{} // 一定要为对象，不能为'',0,null 之类
}

-----------------------------
突然感觉如下的也合适
{
code: 200,// 编码（假设 200~299 的为正常）
msg: '' , // 正确时或错误时用户提示信息,与 code 对应，方便做文案映射
data:{} // 一定要为对象，不能为'',0,null 之类
}
-----------------------------

上面的感觉又变成了 http_code 了，直接 restful 得了，用 http_code 表示不同状态，code 表示业务状态

324

sorshion

2019-03-19 21:43:09 +08:00

@ryanking8215 你的方案比较赞同

325

feikeq

2019-03-19 21:49:31 +08:00 via iPhone

@AngryMagikarp 一样可以配置做国际化语言，我现在就是中英双语，枚举想要的本地化语言文件即可

326

hanxiV2EX

2019-03-19 22:05:30 +08:00 via Android

只要有规范文档，用哪种都行！别改来改去就行。这事没必要吵，浪费时间。只要给够钱，用拼音，用中文都行。

坐等主管来说:我就是那个主管。

327

OnionJuice

2019-03-19 22:06:05 +08:00

@luckyswag
+1，主管管不住人，还叫什么主管，变成前后端的传话小弟。

回楼主
这种返回格式不是一般都由主管定的吗？恕我直言，如果主管规定
{
"1" : "错误码"，
"2" : "错误消息"，
......
}
都可以。
说实话码农就是写代码的，标准是按照 leader 定的，各自一套这样的代码也是屎。

328

tt0411

2019-03-19 22:09:47 +08:00

现在的主管管理要这么精细了? 我们接口都是自己说了算

329

16t

2019-03-19 22:21:46 +08:00

LZ 怕不是直译强迫症吧。。。。。。

330

wunonglin

2019-03-19 22:27:13 +08:00

早上才几个人回复。。。。现在居然能吵 300 多楼？。。也是厉害

331

feelinglucky

2019-03-19 22:40:56 +08:00

@keepeye 一般我也这样子，不接受任何规劝

332

xiaoqi

2019-03-19 23:06:59 +08:00

难道不就是定个规范的事情吗？

333

iceking

2019-03-19 23:25:32 +08:00

"ret", "msg", "data"

334

jzmws

2019-03-19 23:37:05 +08:00

这个要看之前是这么定义的 ,要兼容旧的接口

335

tiaod

2019-03-19 23:40:42 +08:00

这都能翻 4 页，v2 的程序员也是够闲的

336

nodwang

2019-03-19 23:49:07 +08:00 via Android

@tiaod 不瞒您说，我大半夜的翻了 4 页看

337

techme

2019-03-19 23:49:13 +08:00

主管和新来的总监都不会用 git
代码在一个分支上盖来盖去，心累不想管（＝。＝）

338

qianbiTH

2019-03-19 23:50:03 +08:00 via Android

闲的蛋疼，我就要连按 4 下空格，咬我啊

339

huangdayu

2019-03-20 00:04:49 +08:00 via Android

{
"code":200,
"msg":"success",
"decs":"成功",
"data":"List<Obj>"
}

不接受反驳

340

crazyjin

2019-03-20 00:09:22 +08:00

@lincanbin 工作虽然不饱和，但起码人是吃饱了的。。

341

ksharp8

2019-03-20 00:29:01 +08:00

一般用主管那种

342

SNOOPY963

2019-03-20 00:55:04 +08:00

让开让开！

别问！问就是离职！

343

xderam

2019-03-20 01:12:29 +08:00

感觉看大家讨论也能各种涨知识，如果不讨论楼主和其主管的纷争的话，其实挺好的。
个人感觉这玩意应该没有四海统一的标准，楼主尝试下把大家的讨论结果整理下，然后给主管一个建议，他选择哪个就是哪个。然后在论坛里和大家讨论下到底哪个方案更好，单纯和主管讨论多没意思~~~

344

cyssxt

2019-03-20 01:21:55 +08:00 via iPhone

这个怎么吵一天求教

345

BlBana

2019-03-20 01:49:04 +08:00 via Android

有点浪费时间啊 ... 没必要啊

346

congeec

2019-03-20 02:06:27 +08:00

@gtanyin 哈哈哈哈，dmesg 还是挺好用的

347

6260628

2019-03-20 02:10:21 +08:00

听主管的，你有本事就坐他的位置，但感觉一两年内不可能

348

conge

2019-03-20 02:24:27 +08:00

能为这点儿小事儿吵架
说明你俩积怨已深。

349

Trumeet

2019-03-20 04:56:27 +08:00

都怪袁隆平？

350

Trumeet

2019-03-20 04:56:57 +08:00

而且这个 Status Code 直接用 HTTP Status 更好吧，没必要扔到 Response body 里

351

mwftts

2019-03-20 06:01:19 +08:00 via Android

一个编程门外汉来说，status 是的状态码，也可以提示错误以外的代码，例如成功和警告，这样不需要额外的定义

352

xuanbg

2019-03-20 07:14:16 +08:00

看到楼主的返回数据格式，就想起被微信支付接口支配的恐惧。。。我都想不明白为啥正确和错误要返回不同的数据格式？？？我在接到返回数据前，不可能知道结果是正确还是错误阿喂！

353

kingsonl

2019-03-20 07:49:37 +08:00 via iPhone

当然是选择简单明了的所以第一种如果是我 code message

354

ww2000e

2019-03-20 07:51:45 +08:00 via Android

就算听你的，最后得到什么呢。。

355

ryan18

2019-03-20 07:55:55 +08:00 via Android

真好，又一天摸鱼白拿钱

356

kuyuzhiqi

2019-03-20 08:12:19 +08:00 via iPhone

支持主管，你的设计字段名太冗余了

357

httplife

2019-03-20 08:13:34 +08:00

吓得我赶紧看下 api
{
"status": 0,
"error": {
"code": 0,
"message": "string",
"errors": {
"code": 0,
"field": "string",
"description": "string"
}
}
}

358

Marmot

2019-03-20 09:04:42 +08:00

@simonv3ex 那不得天天想办法和漂亮妹子吵架

359

sarices

2019-03-20 09:09:45 +08:00

{
"错误码: 0
"错误信息": "lalala"
}

360

oops1900

2019-03-20 09:10:51 +08:00

其实哈，你是不想再公司待了，这不是借口吵不吵的问题，你想在公司待这还用问么？当然听主管的，感觉找工作吧。新都不在这儿。

361

HackerPainter

2019-03-20 09:11:55 +08:00

@iidestiny 这你都知道？

362

guoyuchuan

2019-03-20 09:12:27 +08:00

看不懂这是为什么，难道我的政治觉悟太低了？

363

saeed

2019-03-20 09:23:41 +08:00

还真看不惯用错误,成功状态都放在 errorcode , 别告诉我只有失败的状态才放在 errorcode 其实用啥都行，实现需求就行　就一个字段名的问题吵一天，真是极品

364

macszh2013

2019-03-20 09:24:32 +08:00

你主管是对的

365

wxl1380610

2019-03-20 09:24:51 +08:00

真闲

366

sutra

2019-03-20 09:27:06 +08:00

我觉得我可以发个广告 https://github.com/sutra/commons-jax-rs/blob/develop/commons-jax-rs-exception-mapper/src/main/java/org/oxerr/commons/ws/rs/exceptionmapper/ErrorEntity.java#L12

367

phper69

2019-03-20 09:31:42 +08:00

主管跟你吵得不是接口，是权力

368

rexyan

2019-03-20 09:45:20 +08:00

建议加上个唯一的 response id

369

xinjiang

2019-03-20 09:45:37 +08:00

先做人，再做技术

370

Honwhy

2019-03-20 09:52:08 +08:00

我的习惯仅供参考
code 对应编码，不完全是数字，比如 S00，B00，S=System B=Business
status 类似于 HttpStatus 的语义，用数字描述，
message, msg, errorMsg, desc，这些都不关键

371

wupher

2019-03-20 09:52:35 +08:00

为个字段名就争执了一天，如果没有历史或者其它原因，值得吗？

372

xinjiang

2019-03-20 09:54:31 +08:00

你这样的人不该在别人手下做事，应该自己开公司自己干，为了一段代码设计和主管吵一天，真是委屈你了

373

jorneyr

2019-03-20 09:56:00 +08:00

难道你们的接口都是返回错误信息么，字段都是描述错误为主 ^_^

374

wmm

2019-03-20 09:56:35 +08:00

{
"code":,
"msg": "",
"data": ......
}

375

ayumi043

2019-03-20 09:58:50 +08:00

服了。两个没本子差别啊，或者有文档说明就 ok 了。这点破事也能吵。

376

justin2018

2019-03-20 09:59:05 +08:00

那年在缅甸，因为赌石，我把护照都压上了，结果还是输了。赌石的地方在缅甸诺瓦达卡村，无奈之下我决定铤而走险，越境回国，可惜被缅甸边防军发现，向我开枪扫射，我左脚中弹，一瘸一拐的奔向祖国一步一步的挪，左脚的疼痛让我难以忍受，记得当时身边好多大树我都没扶，就服你 😁

开个玩笑~~~ 😅
我老大说啥我就做啥子~ 😅