听闻微信开发者文档很差

[anzu]

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

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

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

总的来说也不是什么大问题，但是总在不应该有的小问题上给你整活儿就很讨厌。

[PerFectTime]

文档烂到不能再烂 +10086


字段名很傻，很讨厌一会下划线，一会儿连词，驼峰都没有

[kohoh]

有同感

[kop1989]

明明一些字段说明可以放在 api 当页的（并不复杂），但非要你跳转到某个业务的详细介绍页，让你去一大段文字里去挑那个字段的说明和要求。

[devld]

对比微软、Google ，同样是大厂，但就是感觉国内的乱糟糟的，一点都不优雅

[jdhao]

能跑就行.jpg

[maypu]

更离谱的是，这还是优化后的，几年前的更烂。。。

[hahasong]

小聋：你在教我做事

[czfy]

毕竟是 “小而美”

[uCharles]

公司现在在用企业微信，怂恿改成钉钉中。。。

[Wenco]

headimgurl

[xlsepiphone]

@sugz #9 钉钉的 bot 和企业微信的 bot 哪个好用？

[Williamwang]

@sugz #9 怎么不用飞书哈哈哈

[RealJacob]

@sugz yysy 如果没有企业合作，现在要改，从产品角度没理由不用飞书啊

[uCharles]

@RealJacob 飞书比钉钉更好吗？没怎么研究过飞书~
@Williamwang

[Kaier]

勇敢一点, 把 听闻 这 2 个字给去了. XD

[mason961125]

去看看微信支付每个接口的 **公共错误码** 你会有新的认知。

[HappyFox]

@sugz #14 个人之见，国内使用人数超过十万的办公软件中，面向老板思维的是钉钉，面向运营揽客的是企业微信，飞书是唯一一款面向员工的办公软件，不管是文档、机器人还是开放接口，都用起来很顺手。
当然，如果公司在国外，可以试试 slack 、谷歌全家桶之类的，各有各的优势，适合自家企业文化就好。

[RealJacob]

@sugz 我是做这类型软件的，我只说从‘好用’和‘易用’的角度，飞书确实领先企微和钉钉

[wangsfox]

又不是不能用.jpg

[nziming]

可以说 微信开发者文档说非常差了（最近开发有感）

[NPC666]

张小🐲，你__什么时候__啊

[jadehare]

两三年前看过，具体细节不记得了，但是就记得需求经常变动，隔俩版本可能就要不同的实现方式了

[ChillyPrince]

说白了国内就没啥工程师文化，都是 KPI 逼的

[tty1]

国内认真做的很少

[Chad0000]

先不要说开发文档，你看看注册它的各种平台用了多少个邮箱。。。

[ReferenceE]

不用"听闻"...

[suzic]

文档烂，账号系统烂，api 烂，产品也烂！

[ZRS]

确实垃圾

[docx]

百度也是，之前用他们的接口识图，有的传入 base64 json ，有的直接传 base64 text ，有的 base64 要去掉文件头……
关键在文档里也不区别说明。

[docx]

@suzic #27 瞎说什么，这叫小而美

[azhangbing]

微信本身就很烂。。耗电 占内存 卡等等

[xloger]

微信，QQ ，微博的分享 SDK ，我记得有一家的文档，代码甚至是截图

[z42514]

确实很烂，我之前对接支付的时候，发现他们不同平台字段名还不一样的.......

[joesonw]

@xlsepiphone 请不要侮辱 bot, 都只是一个 webhook. 能 @机器人 出发操作的才是 bot.

[zhady009]

微信服务端的 api 文档还有字段打错的 查了半天才从网上找到正确的参数名..

[wang48ql]

接过微信的登录、支付，也接过支付宝的支付，文档是真的烂，两个相对而言的话，支付宝稍微好一点，
国内巨头对开发者生态真的是太不重视了

[ZeroDu]

大公司里面最烂了，没有之一。各种服务，包括微信支付连 sdk 都没有

[ncepuzs]

@Chad0000 #25 确实，微信、微信公众号和微信开放平台不允许使用同一个邮箱……

[leon0918]

感觉已经不更新了，推出的人拿足了奖金，没有动力了

[tudou01]

飞书天下第一

[Ansen]

同一个产品的，CURD 接口，id 这个字段，一些是 int 一些是 string ，神烦

[pengtdyd]

微信：爱用不用！！！

[LimboRunner]

前段时间被微信支付的接口折磨的不行，报错驴唇不对马嘴，全靠猜，字段一会儿大写一会儿小写，全靠试。

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

狗屎一样的文档，我也能写的这么烂。

[xylxAdai]

之前我也骂，现在进来才发现，微信的开发人员相比它的用户体量来说实在太小了，小的可怜。。
好像是这边比较强调精兵，小团队作战，开发者文档估计就几个人在维护，能及时更新就不错了，其他的，真的没办法的。。

[ppphp]

就是由于某种原因，国内 im 市场缺乏竞争，国外像苹果，谷歌广告这种约等于垄断的平台，文档也很差

[mikuazusa]

阿里云和钉钉的文档更烂

[Bijiabo]

连微信的文档都嫌弃，遇到阿里云的文档岂不是要杀人

[redford42]

微信、钉钉、飞书、welink
四家都对接过
怎么说呢....

微信：企业微信创建部门的接口部门 id 传负数会报错
钉钉：今天刚发现钉钉悄悄改了部门下名称已重复的 errCode ，是的改了 code ，没有更新文档
飞书：更新特别快，深度合作，产品经理说的一个功能，代码已经上线了，文档没更新
welink：emmmm 对外蓝色对内红色，蓝色 bug 多的不行

[fan123199]

很烂，很难受，页面看起来是我要的内容，看是看完感觉还是不会用，基本是要找论坛才到看到能用的教程。

[sytnishizuiai]

@Bijiabo #46 哈哈，赞同。感同身受。

[justfindu]

你要有对比才知道, 微信已经是好的了

[constantine008]

@ncepuzs #38 我之前还发贴问过这个问题 /t/674430

[zhea55]

小程序的部分接口，居然要发布生产环境，才能生成跳转小程序的链接。

连个测试环境都没有。

见怪不怪了。

[zhw2590582]

小程序登录接口和网页二维码登录接口获取的用户信息字段不一样，也不知道为什么这样搞

[Jaosn]

还记得一天晚上和后端一起调试支付的情景

[cheng6563]

企业微信更差

[TomVista]

请你不要侮辱 文档差 这三个字

[g0thic]

虽然微信的开发文档很差，但是已经是国内大厂里综合做的最好的了

[ZeroDu]

相对来说支付宝的文档就很好了，比如支付还有沙箱模式

[24match]

每次反复看都不能看出个所以然

[pkoukk]

还行吧，我的要求不高，示例跑的通就行

[hzder]

最近刚对接过微信。。确实烂，妈的

[lwldcr]

大家都一样烂 就不要比较了

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

一开始还想反馈一下纠错的，后来发现太多了就懒得弄了，所有整数型直接```int64```，所有自定义类型直接按全字段定义

[skinny]

烂，各种返回描述含糊不清，甚至压根没有，让你实际执行再去看返回，然而你测试也需要先申请相关服务，没法根据文档直接开写，你即便申请好了相关服务，因为文档烂，你还是得搜索别人的代码看别人踩过的坑，不然你不小心就运行不了。 还有各种数据长度大小限制也不说，言辞之间好像随时会变，实际又很多年没有变，设计数据库时写个列限制都没法写。

[skinny]

还有有的字段到底可以填什么也不写清楚，同一个 API 不同页面的说法不一样，还得看别人踩过的坑才能知道到底怎么写。

[anzu]

又发现一个，同一个字段在不同接口的长度限制不一样...我暂且取交集得了

[legiorange]

被微信支付和微信小程序文档劝退，已完全放弃微信端开发……

[lskjdfgl]

还有一个，也不知道那个王八蛋写的 [字符串] 不适用于汉字