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

听闻微信开发者文档很差

  •  
  •   anzu · 38 天前 · 4955 次点击
    这是一个创建于 38 天前的主题,其中的信息可能已经有所发展或是发生改变。
    实际试过之后才知道有多烂
    1. 命名风格不统一
    同一个接口,一个字段命名为 xxxid ,另一个为 xxx_id 。大概他们自己也觉得蠢,在下一个版本的接口中统一为 xxxid 。

    2. 描述不清
    一个字段描述是需要随机字符串,没有说明任何字符限制。按照字面理解,我传 random ascii ,结果错!只好老实按照他给的示例值 字母 + 数字 生成,至今不知道是不是做了这个字符限制,懒得再试其它字符。

    3. 描述不清 2
    接口需要传 json ,有的字段标注非必填。按照我的理解,非必填那就传 null ,结果错!人家的意思是连字段名都不传。不知道他们用的什么开发,是不是很难兼容两种情况,反正我的项目是能轻易兼容的。

    总的来说也不是什么大问题,但是总在不应该有的小问题上给你整活儿就很讨厌。
    68 条回复    2021-11-02 09:51:40 +08:00
    PerFectTime
        1
    PerFectTime  
       38 天前
    文档烂到不能再烂 +10086


    字段名很傻,很讨厌一会下划线,一会儿连词,驼峰都没有
    kohoh
        2
    kohoh  
       38 天前
    有同感
    kop1989
        3
    kop1989  
       38 天前   ❤️ 3
    明明一些字段说明可以放在 api 当页的(并不复杂),但非要你跳转到某个业务的详细介绍页,让你去一大段文字里去挑那个字段的说明和要求。
    devld
        4
    devld  
       38 天前 via Android   ❤️ 1
    对比微软、Google ,同样是大厂,但就是感觉国内的乱糟糟的,一点都不优雅
    jdhao
        5
    jdhao  
       38 天前 via Android
    能跑就行.jpg
    maypu
        6
    maypu  
       38 天前
    更离谱的是,这还是优化后的,几年前的更烂。。。
    hahasong
        7
    hahasong  
       38 天前
    小聋:你在教我做事
    czfy
        8
    czfy  
       38 天前
    毕竟是 “小而美”
    sugz
        9
    sugz  
       38 天前   ❤️ 1
    公司现在在用企业微信,怂恿改成钉钉中。。。
    Wenco
        10
    Wenco  
       38 天前
    headimgurl
    xlsepiphone
        11
    xlsepiphone  
       38 天前
    @sugz #9 钉钉的 bot 和企业微信的 bot 哪个好用?
    Williamwang
        12
    Williamwang  
       38 天前
    @sugz #9 怎么不用飞书哈哈哈
    RealJacob
        13
    RealJacob  
       38 天前
    @sugz yysy 如果没有企业合作,现在要改,从产品角度没理由不用飞书啊
    sugz
        14
    sugz  
       38 天前
    @RealJacob 飞书比钉钉更好吗?没怎么研究过飞书~
    @Williamwang
    Kaier
        15
    Kaier  
       38 天前   ❤️ 1
    勇敢一点, 把 听闻 这 2 个字给去了. XD
    mason961125
        16
    mason961125  
       38 天前   ❤️ 1
    去看看微信支付每个接口的 **公共错误码** 你会有新的认知。
    HappyFox
        17
    HappyFox  
       38 天前
    @sugz #14 个人之见,国内使用人数超过十万的办公软件中,面向老板思维的是钉钉,面向运营揽客的是企业微信,飞书是唯一一款面向员工的办公软件,不管是文档、机器人还是开放接口,都用起来很顺手。
    当然,如果公司在国外,可以试试 slack 、谷歌全家桶之类的,各有各的优势,适合自家企业文化就好。
    RealJacob
        18
    RealJacob  
       38 天前
    @sugz 我是做这类型软件的,我只说从‘好用’和‘易用’的角度,飞书确实领先企微和钉钉
    wangsfox
        19
    wangsfox  
       38 天前
    又不是不能用.jpg
    nziming
        20
    nziming  
       38 天前
    可以说 微信开发者文档说非常差了(最近开发有感)
    NPC666
        21
    NPC666  
       38 天前 via Android
    张小🐲,你__什么时候__啊
    jadehare
        22
    jadehare  
       38 天前
    两三年前看过,具体细节不记得了,但是就记得需求经常变动,隔俩版本可能就要不同的实现方式了
    ChillyPrince
        23
    ChillyPrince  
       38 天前   ❤️ 1
    说白了国内就没啥工程师文化,都是 KPI 逼的
    tty1
        24
    tty1  
       38 天前
    国内认真做的很少
    Chad0000
        25
    Chad0000  
       38 天前
    先不要说开发文档,你看看注册它的各种平台用了多少个邮箱。。。
    ReferenceE
        26
    ReferenceE  
       38 天前 via Android
    不用"听闻"...
    suzic
        27
    suzic  
       38 天前 via Android
    文档烂,账号系统烂,api 烂,产品也烂!
    ZRS
        28
    ZRS  
       38 天前 via iPhone
    确实垃圾
    dzyou2007
        29
    dzyou2007  
       38 天前
    百度也是,之前用他们的接口识图,有的传入 base64 json ,有的直接传 base64 text ,有的 base64 要去掉文件头……
    关键在文档里也不区别说明。
    dzyou2007
        30
    dzyou2007  
       38 天前
    @suzic #27 瞎说什么,这叫小而美
    azhangbing
        31
    azhangbing  
       38 天前
    微信本身就很烂。。耗电 占内存 卡等等
    xloger
        32
    xloger  
       38 天前
    微信,QQ ,微博的分享 SDK ,我记得有一家的文档,代码甚至是截图
    z42514
        33
    z42514  
       38 天前
    确实很烂,我之前对接支付的时候,发现他们不同平台字段名还不一样的.......
    joesonw
        34
    joesonw  
       38 天前
    @xlsepiphone 请不要侮辱 bot, 都只是一个 webhook. 能 @机器人 出发操作的才是 bot.
    zhady009
        35
    zhady009  
       38 天前
    微信服务端的 api 文档还有字段打错的 查了半天才从网上找到正确的参数名..
    wang48ql
        36
    wang48ql  
       38 天前
    接过微信的登录、支付,也接过支付宝的支付,文档是真的烂,两个相对而言的话,支付宝稍微好一点,
    国内巨头对开发者生态真的是太不重视了
    ZeroDu
        37
    ZeroDu  
       38 天前
    大公司里面最烂了,没有之一。各种服务,包括微信支付连 sdk 都没有
    ncepuzs
        38
    ncepuzs  
       38 天前
    @Chad0000 #25 确实,微信、微信公众号和微信开放平台不允许使用同一个邮箱……
    leon0918
        39
    leon0918  
       38 天前
    感觉已经不更新了,推出的人拿足了奖金,没有动力了
    tudou01
        40
    tudou01  
       38 天前 via iPhone
    飞书天下第一
    Ansen
        41
    Ansen  
       38 天前
    同一个产品的,CURD 接口,id 这个字段,一些是 int 一些是 string ,神烦
    pengtdyd
        42
    pengtdyd  
       38 天前
    微信:爱用不用!!!
    LimboRunner
        43
    LimboRunner  
       38 天前
    前段时间被微信支付的接口折磨的不行,报错驴唇不对马嘴,全靠猜,字段一会儿大写一会儿小写,全靠试。

    不做不知道,一做才发现,腾讯这种大厂跟我们小作坊的水平其实差不多嘛。

    狗屎一样的文档,我也能写的这么烂。
    xylxAdai
        44
    xylxAdai  
       38 天前
    之前我也骂,现在进来才发现,微信的开发人员相比它的用户体量来说实在太小了,小的可怜。。
    好像是这边比较强调精兵,小团队作战,开发者文档估计就几个人在维护,能及时更新就不错了,其他的,真的没办法的。。
    ppphp
        45
    ppphp  
       38 天前
    就是由于某种原因,国内 im 市场缺乏竞争,国外像苹果,谷歌广告这种约等于垄断的平台,文档也很差
    mikuazusa
        46
    mikuazusa  
       38 天前
    阿里云和钉钉的文档更烂
    Bijiabo
        47
    Bijiabo  
       38 天前   ❤️ 4
    连微信的文档都嫌弃,遇到阿里云的文档岂不是要杀人
    redford42
        48
    redford42  
       38 天前
    微信、钉钉、飞书、welink
    四家都对接过
    怎么说呢....

    微信:企业微信创建部门的接口部门 id 传负数会报错
    钉钉:今天刚发现钉钉悄悄改了部门下名称已重复的 errCode ,是的改了 code ,没有更新文档
    飞书:更新特别快,深度合作,产品经理说的一个功能,代码已经上线了,文档没更新
    welink:emmmm 对外蓝色对内红色,蓝色 bug 多的不行
    fan123199
        49
    fan123199  
       38 天前
    很烂,很难受,页面看起来是我要的内容,看是看完感觉还是不会用,基本是要找论坛才到看到能用的教程。
    sytnishizuiai
        50
    sytnishizuiai  
       38 天前
    @Bijiabo #46 哈哈,赞同。感同身受。
    justfindu
        51
    justfindu  
       37 天前
    你要有对比才知道, 微信已经是好的了
    constantine008
        52
    constantine008  
       37 天前
    @ncepuzs #38 我之前还发贴问过这个问题 /t/674430
    zhea55
        53
    zhea55  
       37 天前
    小程序的部分接口,居然要发布生产环境,才能生成跳转小程序的链接。

    连个测试环境都没有。

    见怪不怪了。
    zhw2590582
        54
    zhw2590582  
       37 天前
    小程序登录接口和网页二维码登录接口获取的用户信息字段不一样,也不知道为什么这样搞
    Jaosn
        55
    Jaosn  
       37 天前
    还记得一天晚上和后端一起调试支付的情景
    cheng6563
        56
    cheng6563  
       37 天前
    企业微信更差
    TomVista
        57
    TomVista  
       37 天前
    请你不要侮辱 文档差 这三个字
    g0thic
        58
    g0thic  
       37 天前
    虽然微信的开发文档很差,但是已经是国内大厂里综合做的最好的了
    ZeroDu
        59
    ZeroDu  
       37 天前
    相对来说支付宝的文档就很好了,比如支付还有沙箱模式
    24match
        60
    24match  
       37 天前
    每次反复看都不能看出个所以然
    pkoukk
        61
    pkoukk  
       37 天前
    还行吧,我的要求不高,示例跑的通就行
    hzder
        62
    hzder  
       37 天前
    最近刚对接过微信。。确实烂,妈的
    lwldcr
        63
    lwldcr  
       37 天前
    大家都一样烂 就不要比较了

    我项目里用到的字节的巨量引擎文档
    * 字段类型标注里整数型用到了```number```,```int```,老老实实写个 int/int32/int64 能死,你项目后端本身不就是 go 实现的,用 go 的类型定义不就行了
    * 还是类型说明,对于嵌套类型,有些直接写个```json```,, 有些直接写个```json[]```,还有些写的是```object```, ```object[]```

    一开始还想反馈一下纠错的,后来发现太多了就懒得弄了,所有整数型直接```int64```,所有自定义类型直接按全字段定义
    skinny
        64
    skinny  
       37 天前
    烂,各种返回描述含糊不清,甚至压根没有,让你实际执行再去看返回,然而你测试也需要先申请相关服务,没法根据文档直接开写,你即便申请好了相关服务,因为文档烂,你还是得搜索别人的代码看别人踩过的坑,不然你不小心就运行不了。 还有各种数据长度大小限制也不说,言辞之间好像随时会变,实际又很多年没有变,设计数据库时写个列限制都没法写。
    skinny
        65
    skinny  
       37 天前
    还有有的字段到底可以填什么也不写清楚,同一个 API 不同页面的说法不一样,还得看别人踩过的坑才能知道到底怎么写。
    anzu
        66
    anzu  
    OP
       37 天前
    又发现一个,同一个字段在不同接口的长度限制不一样...我暂且取交集得了
    legiorange
        67
    legiorange  
       37 天前
    被微信支付和微信小程序文档劝退,已完全放弃微信端开发……
    lskjdfgl
        68
    lskjdfgl  
       33 天前
    还有一个,也不知道那个王八蛋写的 [字符串] 不适用于汉字
    关于   ·   帮助文档   ·   API   ·   FAQ   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   1629 人在线   最高记录 5497   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 31ms · UTC 00:19 · PVG 08:19 · LAX 16:19 · JFK 19:19
    ♥ Do have faith in what you're doing.