听闻微信开发者文档很差

2021-10-28 10:10:20 +08:00
 anzu
实际试过之后才知道有多烂
1. 命名风格不统一
同一个接口,一个字段命名为 xxxid ,另一个为 xxx_id 。大概他们自己也觉得蠢,在下一个版本的接口中统一为 xxxid 。

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

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

总的来说也不是什么大问题,但是总在不应该有的小问题上给你整活儿就很讨厌。
6750 次点击
所在节点    微信
68 条回复
Ansen
2021-10-28 20:49:00 +08:00
同一个产品的,CURD 接口,id 这个字段,一些是 int 一些是 string ,神烦
pengtdyd
2021-10-28 21:12:03 +08:00
微信:爱用不用!!!
LimboRunner
2021-10-28 21:51:50 +08:00
前段时间被微信支付的接口折磨的不行,报错驴唇不对马嘴,全靠猜,字段一会儿大写一会儿小写,全靠试。

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

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

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

连个测试环境都没有。

见怪不怪了。
zhw2590582
2021-10-29 09:10:16 +08:00
小程序登录接口和网页二维码登录接口获取的用户信息字段不一样,也不知道为什么这样搞
Jaosn
2021-10-29 09:27:30 +08:00
还记得一天晚上和后端一起调试支付的情景
cheng6563
2021-10-29 09:28:55 +08:00
企业微信更差
TomVista
2021-10-29 09:31:35 +08:00
请你不要侮辱 文档差 这三个字
g0thic
2021-10-29 09:35:26 +08:00
虽然微信的开发文档很差,但是已经是国内大厂里综合做的最好的了
ZeroDu
2021-10-29 09:37:58 +08:00
相对来说支付宝的文档就很好了,比如支付还有沙箱模式
24match
2021-10-29 09:42:55 +08:00
每次反复看都不能看出个所以然

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/811162

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX