• 请不要在回答技术问题时复制粘贴 AI 生成的内容
darkmatter
V2EX  ›  程序员

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

  •  
  •   darkmatter · Oct 16, 2018 · 7003 views
    This topic created in 2941 days ago, the information mentioned may be changed or developed.
    文档写的模棱两可,问他又不耐烦。
    32 replies  •  2018-10-17 18:05:46 +08:00
    BingoXuan
    BingoXuan
    Oct 16, 2018 via Android
    1
    更可怕的是人家把你的接口 /框架改成一坨屎之后扔回给你用
    niaobulashi
    niaobulashi
    Oct 16, 2018
    2
    可以去投诉
    schemesAlot
    schemesAlot
    Oct 16, 2018
    3
    都给你 API 了,已经很好了!!
    Deville
    Deville
    Oct 16, 2018❤️1
    4
    居然有文档!
    zhengxiaowai
    zhengxiaowai
    Oct 16, 2018❤️7
    5
    有时间我觉得调用自己的 API 其实也挺烦躁的。。
    songkl
    songkl
    Oct 16, 2018❤️1
    6
    等你有问题 各种验证之后确定是 API 问题的时候,“哎呀 忘了改文档了,这个参数 几个版本前就改了”
    cuzfinal
    cuzfinal
    Oct 16, 2018❤️1
    7
    我遇到过代码未动,文档现行。写完后别人告诉你这个借口没实现。
    NotNil1
    NotNil1
    Oct 16, 2018
    8
    所以 swagger 很好用啊,代码改了,接口文档就同步改了
    susucoolsama
    susucoolsama
    Oct 16, 2018
    9
    swagger+1,但是 swagger 文档的标准写法我也不是很清楚怎么用。
    YvenChang
    YvenChang
    Oct 16, 2018 via iPhone
    10
    最近对接的一个项目,接口文档里写着的加密模式,无论怎样我都通不过验证(而且接口错误信息极其模糊),后面要过来对面的加密代码才发现完全不是文档里写的那个。我真是 rstdm
    amao12580
    amao12580
    Oct 16, 2018
    11
    其实还是一个信息对称的问题,亘古难题
    Akiyu
    Akiyu
    Oct 16, 2018
    12
    @songkl #7
    形象!!!! 画面感超强
    DamonLin
    DamonLin
    Oct 16, 2018
    13
    居然有文档
    pricelessLucky
    pricelessLucky
    Oct 16, 2018
    14
    @cuzfinal 我的习惯也是先写文档,不过会先备注(未完成) 233
    vagranth
    vagranth
    Oct 16, 2018
    15
    我到现在也没完全想通文档和代码不同步应该怎么办。java 倒是有 javadoc,c++我就没辙了。
    对我来说,我只能尽量的按照一个好习惯写自解释的代码。期待别人看到接口名字就知道是干嘛的。
    scnace
    scnace
    Oct 16, 2018 via Android
    16
    (同一个公司倒还好 还有撕的空间)调其他厂商的接口才蛋疼…… 你好不容易自己靠着猜和蒙 终于他们的接口不报错了 然后这个接口大概过了 5 分钟(可能更久)左右 给你来了一大段跟文档不一样的 xml ……… 然后你找别人 别人还不鸟你………
    zwh2698
    zwh2698
    Oct 16, 2018 via Android
    17
    请问有多少 API 不是别人的?从基本系统调用,语言环境,不都是别人的
    momo1999
    momo1999
    Oct 16, 2018 via Android
    18
    还有给的 url 是错的呢,文档估计从上个公司偷的
    leemove
    leemove
    Oct 16, 2018
    19
    练就了一身好武功,没事就看看后端代码,能猜个八九不离十.
    yu13n
    yu13n
    Oct 16, 2018 via Android
    20
    更痛苦的是发现 api 是错的
    FakeLeung
    FakeLeung
    Oct 16, 2018 via Android
    21
    问下,你们调用别人的 API 都是走 http 的吗?就是模拟一个请求酱紫?
    dobelee
    dobelee
    Oct 16, 2018 via Android
    22
    卧槽居然有文档,良心啊。
    fkdog
    fkdog
    Oct 16, 2018
    23
    这个还是要看对接人。
    关系好的话,接口有问题的话说一下,两人还可以相互打闹一下,吐槽写的接口太辣鸡了。。
    关系不好的话,太难受了。。
    特别是碰到我这样的颜控[doge]
    vipppppp
    vipppppp
    Oct 17, 2018
    24
    痛苦的是上次 java 工程师告诉我某个字段传 date 类型,没学过 Java 的表示不同语言 date 的 json 序列化长得可能不一样,然后他还是坚持说 Date 类型,如果 python 没有的话,那么他就改个类型。。
    kirinzer
    kirinzer
    Oct 17, 2018
    25
    用过淘宝联盟的 api,两个字垃圾,接口文档不匹配,该返回的字段不返回,最牛逼的是用着用着结构就改了。。。估计都是招的实习生吧,要不就是外包的
    IssacTomatoTan
    IssacTomatoTan
    Oct 17, 2018 via Android
    26
    我遇到过直接返回数据库数据 我来处理逻辑的
    lovesan
    lovesan
    Oct 17, 2018
    27
    @cuzfinal 你说的好像是我- -! 哈哈 我都是这么干的 要不然一个劲的崔受不了啊,先写着,完了再更新文档。不过我一般不跟别人撕,说哪有问题的直接提交,我肯定是去看的。。
    whitepoppy
    whitepoppy
    Oct 17, 2018
    28
    @IssacTomatoTan 老铁在茫茫人海找到你不容易啊 握个抓把 233
    yufeiminds
    yufeiminds
    Oct 17, 2018
    29
    @vipppppp 是时候祭出 RFC3339/ISO8601 了
    godoway
    godoway
    Oct 17, 2018
    30
    @vipppppp 那么就传 timestamp 吧
    vipppppp
    vipppppp
    Oct 17, 2018
    31
    @FakeLeung 如果做 web 的话 接触到的 api 基本都是走 http 的吧 当然也有其他的,例如 kafka,
    vipppppp
    vipppppp
    Oct 17, 2018
    32
    @godoway
    是的,我和他说了很久,要他去了解 java date 到底 json 序列化后长什么样,过了很久很久,他终于回复我是 timestamp
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   3827 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 116ms · UTC 05:29 · PVG 13:29 · LAX 21:29 · JFK 00:29
    ♥ Do have faith in what you're doing.