这世界上最痛苦的事莫过于调用别人的 API 了。。

[darkmatter]

文档写的模棱两可，问他又不耐烦。

[BingoXuan]

更可怕的是人家把你的接口 /框架改成一坨屎之后扔回给你用

[niaobulashi]

可以去投诉

[leafiy]

都给你 API 了，已经很好了！！

[Deville]

居然有文档！

[zhengxiaowai]

有时间我觉得调用自己的 API 其实也挺烦躁的。。

[songkl]

等你有问题 各种验证之后确定是 API 问题的时候，“哎呀 忘了改文档了，这个参数 几个版本前就改了”

[cuzfinal]

我遇到过代码未动，文档现行。写完后别人告诉你这个借口没实现。

[NotNil1]

所以 swagger 很好用啊，代码改了，接口文档就同步改了

[susucoolsama]

swagger+1，但是 swagger 文档的标准写法我也不是很清楚怎么用。

[YvenChang]

最近对接的一个项目，接口文档里写着的加密模式，无论怎样我都通不过验证（而且接口错误信息极其模糊），后面要过来对面的加密代码才发现完全不是文档里写的那个。我真是 rstdm

[amao12580]

其实还是一个信息对称的问题，亘古难题

[Akiyu]

@songkl #7
形象!!!! 画面感超强

[DamonLin]

居然有文档

[pricelessLucky]

@cuzfinal 我的习惯也是先写文档，不过会先备注（未完成） 233

[vagranth]

我到现在也没完全想通文档和代码不同步应该怎么办。java 倒是有 javadoc，c++我就没辙了。
对我来说，我只能尽量的按照一个好习惯写自解释的代码。期待别人看到接口名字就知道是干嘛的。

[scnace]

（同一个公司倒还好 还有撕的空间）调其他厂商的接口才蛋疼…… 你好不容易自己靠着猜和蒙 终于他们的接口不报错了 然后这个接口大概过了 5 分钟(可能更久)左右 给你来了一大段跟文档不一样的 xml ……… 然后你找别人 别人还不鸟你………

[zwh2698]

请问有多少 API 不是别人的？从基本系统调用，语言环境，不都是别人的

[shuax]

还有给的 url 是错的呢，文档估计从上个公司偷的

[leemove]

练就了一身好武功,没事就看看后端代码,能猜个八九不离十.

[Tuuure]

更痛苦的是发现 api 是错的