V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
darkmatter
V2EX  ›  程序员

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

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