V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member Sign In
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
This topic created in 2760 days ago, the information mentioned may be changed or developed.
文档写的模棱两可，问他又不耐烦。
 |
1
BingoXuan Oct 16, 2018 via Android
更可怕的是人家把你的接口 /框架改成一坨屎之后扔回给你用
|
 |
2
niaobulashi Oct 16, 2018
可以去投诉
|
 |
3
leafiy Oct 16, 2018
都给你 API 了，已经很好了！！
|
 |
4
Deville Oct 16, 2018  1
居然有文档！
|
 |
5
zhengxiaowai Oct 16, 2018 7
有时间我觉得调用自己的 API 其实也挺烦躁的。。
|
 |
6
songkl Oct 16, 2018 1
等你有问题 各种验证之后确定是 API 问题的时候，“哎呀 忘了改文档了，这个参数 几个版本前就改了”
|
 |
7
cuzfinal Oct 16, 2018 1
我遇到过代码未动，文档现行。写完后别人告诉你这个借口没实现。
|
 |
8
NotNil1 Oct 16, 2018
所以 swagger 很好用啊，代码改了，接口文档就同步改了
|
 |
9
susucoolsama Oct 16, 2018
swagger+1，但是 swagger 文档的标准写法我也不是很清楚怎么用。
|
 |
10
YvenChang Oct 16, 2018 via iPhone
最近对接的一个项目，接口文档里写着的加密模式，无论怎样我都通不过验证（而且接口错误信息极其模糊），后面要过来对面的加密代码才发现完全不是文档里写的那个。我真是 rstdm
|
 |
11
amao12580 Oct 16, 2018
其实还是一个信息对称的问题，亘古难题
|
 |
13
DamonLin Oct 16, 2018
居然有文档
|
 |
14
pricelessLucky Oct 16, 2018
@cuzfinal 我的习惯也是先写文档，不过会先备注（未完成） 233
|
 |
15
vagranth Oct 16, 2018
我到现在也没完全想通文档和代码不同步应该怎么办。java 倒是有 javadoc，c++我就没辙了。
对我来说，我只能尽量的按照一个好习惯写自解释的代码。期待别人看到接口名字就知道是干嘛的。 |
 |
16
scnace Oct 16, 2018 via Android
（同一个公司倒还好 还有撕的空间）调其他厂商的接口才蛋疼…… 你好不容易自己靠着猜和蒙 终于他们的接口不报错了 然后这个接口大概过了 5 分钟(可能更久)左右 给你来了一大段跟文档不一样的 xml ……… 然后你找别人 别人还不鸟你………
|
 |
17
zwh2698 Oct 16, 2018 via Android
请问有多少 API 不是别人的？从基本系统调用，语言环境，不都是别人的
|
 |
18
momo1999 Oct 16, 2018 via Android
还有给的 url 是错的呢，文档估计从上个公司偷的
|
 |
19
leemove Oct 16, 2018
练就了一身好武功,没事就看看后端代码,能猜个八九不离十.
|
 |
20
yu13n Oct 16, 2018 via Android
更痛苦的是发现 api 是错的
|
 |
21
FakeLeung Oct 16, 2018 via Android
问下，你们调用别人的 API 都是走 http 的吗？就是模拟一个请求酱紫？
|
 |
22
dobelee Oct 16, 2018 via Android
卧槽居然有文档，良心啊。
|
 |
23
fkdog Oct 16, 2018
这个还是要看对接人。
关系好的话，接口有问题的话说一下，两人还可以相互打闹一下，吐槽写的接口太辣鸡了。。 关系不好的话，太难受了。。 特别是碰到我这样的颜控[doge] |
 |
24
vipppppp Oct 17, 2018
痛苦的是上次 java 工程师告诉我某个字段传 date 类型，没学过 Java 的表示不同语言 date 的 json 序列化长得可能不一样，然后他还是坚持说 Date 类型，如果 python 没有的话，那么他就改个类型。。
|
 |
25
kirinzer Oct 17, 2018
用过淘宝联盟的 api，两个字垃圾，接口文档不匹配，该返回的字段不返回，最牛逼的是用着用着结构就改了。。。估计都是招的实习生吧，要不就是外包的
|
 |
26
IssacTomatoTan Oct 17, 2018 via Android
我遇到过直接返回数据库数据 我来处理逻辑的
|
 |
27
lovesan Oct 17, 2018
@cuzfinal 你说的好像是我- -！ 哈哈 我都是这么干的 要不然一个劲的崔受不了啊，先写着，完了再更新文档。不过我一般不跟别人撕，说哪有问题的直接提交，我肯定是去看的。。
|
 |
28
whitepoppy Oct 17, 2018
@IssacTomatoTan 老铁在茫茫人海找到你不容易啊 握个抓把 233
|
 |
29
yufeiminds Oct 17, 2018
@vipppppp 是时候祭出 RFC3339/ISO8601 了
|
Select Language