不看文档的前端我真的很反感

2023-09-05 10:48:18 +08:00
 brader
就一个接口签名机制,我已经详细的给出了签名步骤的文档,并辅助性的给出了服务端版的代码示例实现(抱歉我没有能力提供 objective-c 版本的),两位女同志 IOS ,第一次接入不细看文档,反反复复的问我忍了,接入过程中喜欢截图提供 objective-c 的代码报错好似让我给她 debug 一样我也忍了。
这套签名机制上线以来,她们已经接入超过 3 个项目了,今天大早上还有个人来问我这样的问题,我真的不知道怎么吐槽好,我觉得这已经不属于技术范围的问题了,这是纯不看文档



部分文档截图:
11686 次点击
所在节点    程序员
110 条回复
manning
2023-09-05 11:48:04 +08:00
dumbass
2023-09-05 11:48:24 +08:00
不是写 js 的咱前端不认哦🐶
crazyTanuki
2023-09-05 11:51:22 +08:00
原生开发不是前端🐱
mango111
2023-09-05 11:58:14 +08:00
这不是客户端吗?哪来的前端
oxromantic
2023-09-05 12:01:31 +08:00
说个题外话,你们这个 code 设计的好别扭,既然参考 http 200 视为成功,为啥 302 又是需要登录。。401 给参数错误用了,实际上参数错误 400 更合适
streamrx
2023-09-05 12:02:59 +08:00
你别回答他问题,直接让她们滚去看文档就行了 , 惯的
des
2023-09-05 12:05:56 +08:00
@mango111 客户端也可以算作前端,不只是 web
lambdaq
2023-09-05 12:11:55 +08:00
你就把事情搞大,拉他领导开电话会议商讨这个错误码应该如何定。
brader
2023-09-05 12:20:45 +08:00
@oxromantic 本业务码不遵循 HTTP 状态码规范,不要过渡解读和映射,按文档实现即可。
我可以给你讲讲我这么设计的心里想法,其实我整个项目的 API 响应,应该有 95%以上都是都是响应 200 、400 的,出于特殊响应需要、调试需要、对接阶段会频繁出现的错误的情况,独立出了 200 、400 之外的一些特殊业务码,项目正常上线后,我观测线上 LOG ,其实是几乎没有特殊码出现的。
孰优孰劣,个人看法,不喜勿怪
z1645444
2023-09-05 12:26:57 +08:00
不管是什么方向的开发,主打伸手还觉得理所应得,真的很恶心😡
noreplay
2023-09-05 12:54:07 +08:00
@shizaia 这个绿字就很灵性了😂
buffzty
2023-09-05 13:25:25 +08:00
我是后端 我所有的接口都是 post+json , 不然就等着被问吧 为什么我接口 404 啊
1016
2023-09-05 13:55:16 +08:00
请你分清楚工种 谢谢您勒,前端是前端,ios 是 ios ,安卓是安卓。而不是 ios 和安卓都归于前端😅
8355
2023-09-05 13:57:58 +08:00
文档截图+链接发群里啊。
当然是要包容(公开处刑)了
mango111
2023-09-05 14:08:32 +08:00
@des 这下大前端了
fantathat
2023-09-05 14:21:36 +08:00
也许人家并不知道你的文档有写,或者并不知道要看文档,或看文档更有益于解决,也不知道直接问你对接会引起你反感,毕竟接口对接需要接口,而接口的定义人家并不知道而又需要
brader
2023-09-05 14:25:31 +08:00
@fantathat 这个就纯属笑话了,我上面说了,这套机制接入超过 3 个项目了,第一次提供文档的时候,发群里了,客户端以前已经实现过这套机制了,你说没看过那份文档,真就是借口了
litchinn
2023-09-05 14:30:03 +08:00
例会上直接提出,并以退为进
“关于错误码的定义,我发现在经过三个项目之后,仍有部分同事对此并不完全了解,我希望能充分了解这部分同事对文档的疑问,以及使用上到底有什么问题,文档是否完善,是否需要令相关人员共同商议协定新的错误码定义,并重新完善文档”
Mithril
2023-09-05 14:31:51 +08:00
他们就是把你当 ChatGPT ,对于有的人来说,浪费别人时间是没有成本的,而且节省了自己翻文档的时间。

你要是不想起冲突,那就每次延迟 2~4 小时再回复他。
o562dsRcFqYl375i
2023-09-05 14:39:29 +08:00
有没有一种可能,她们想追你 doge

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

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

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

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

© 2021 V2EX