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

V2EX = way to explore

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

现在注册

已注册用户请登录

• 请不要在回答技术问题时复制粘贴 AI 生成的内容

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

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

API

模棱两可

不耐烦

调用

32 条回复 • 2018-10-17 18:05:46 +08:00

BingoXuan

2018-10-16 15:59:03 +08:00 via Android

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

niaobulashi

2018-10-16 16:11:23 +08:00

可以去投诉

leafiy

2018-10-16 16:20:14 +08:00

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

Deville

2018-10-16 16:30:32 +08:00

居然有文档！

zhengxiaowai

2018-10-16 16:42:33 +08:00

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

songkl

2018-10-16 18:11:22 +08:00

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

cuzfinal

2018-10-16 18:37:44 +08:00

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

NotNil1

2018-10-16 18:44:14 +08:00

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

susucoolsama

2018-10-16 18:45:54 +08:00

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

YvenChang

2018-10-16 19:01:12 +08:00 via iPhone

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

amao12580

2018-10-16 19:06:41 +08:00

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

Akiyu

2018-10-16 19:07:54 +08:00

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

DamonLin

2018-10-16 19:08:59 +08:00

居然有文档

pricelessLucky

2018-10-16 19:12:52 +08:00

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

vagranth

2018-10-16 19:23:59 +08:00

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

scnace

2018-10-16 20:05:24 +08:00 via Android

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

zwh2698

2018-10-16 20:35:05 +08:00 via Android

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

shuax

2018-10-16 20:40:53 +08:00 via Android

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

leemove

2018-10-16 20:43:05 +08:00

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

Tuuure

2018-10-16 20:58:31 +08:00 via Android

更痛苦的是发现 api 是错的

FakeLeung

2018-10-16 21:42:53 +08:00 via Android

问下，你们调用别人的 API 都是走 http 的吗？就是模拟一个请求酱紫？

dobelee

2018-10-16 21:44:04 +08:00 via Android

卧槽居然有文档，良心啊。

fkdog

2018-10-16 22:15:58 +08:00

这个还是要看对接人。
关系好的话，接口有问题的话说一下，两人还可以相互打闹一下，吐槽写的接口太辣鸡了。。
关系不好的话，太难受了。。
特别是碰到我这样的颜控[doge]

vipppppp

2018-10-17 09:21:23 +08:00

痛苦的是上次 java 工程师告诉我某个字段传 date 类型，没学过 Java 的表示不同语言 date 的 json 序列化长得可能不一样，然后他还是坚持说 Date 类型，如果 python 没有的话，那么他就改个类型。。

kirinzer

2018-10-17 09:50:26 +08:00

用过淘宝联盟的 api，两个字垃圾，接口文档不匹配，该返回的字段不返回，最牛逼的是用着用着结构就改了。。。估计都是招的实习生吧，要不就是外包的

IssacTomatoTan

2018-10-17 10:18:51 +08:00 via Android

我遇到过直接返回数据库数据我来处理逻辑的

lovesan

2018-10-17 10:24:25 +08:00

@cuzfinal 你说的好像是我- -！哈哈我都是这么干的要不然一个劲的崔受不了啊，先写着，完了再更新文档。不过我一般不跟别人撕，说哪有问题的直接提交，我肯定是去看的。。

whitepoppy

2018-10-17 11:30:35 +08:00

@IssacTomatoTan 老铁在茫茫人海找到你不容易啊握个抓把 233

yufeiminds

2018-10-17 13:34:18 +08:00

@vipppppp 是时候祭出 RFC3339/ISO8601 了

godoway

2018-10-17 17:42:56 +08:00

@vipppppp 那么就传 timestamp 吧

vipppppp

2018-10-17 18:04:26 +08:00

@FakeLeung 如果做 web 的话接触到的 api 基本都是走 http 的吧当然也有其他的，例如 kafka，

vipppppp

2018-10-17 18:05:46 +08:00

@godoway
是的，我和他说了很久，要他去了解 java date 到底 json 序列化后长什么样，过了很久很久，他终于回复我是 timestamp