这是一个创建于 1446 天前的主题，其中的信息可能已经有所发展或是发生改变。
实际试过之后才知道有多烂
1. 命名风格不统一
同一个接口，一个字段命名为 xxxid ，另一个为 xxx_id 。大概他们自己也觉得蠢，在下一个版本的接口中统一为 xxxid 。
2. 描述清
一个字段描述是需要随机字符串，没有说明任何字符限制。按照字面理解，我传 random ascii ，结果错！只好老实按照他给的示例值 字母 + 数字 生成，至今不知道是不是做了这个字符限制，懒得再试其它字符。
3. 描述不清 2
接口需要传 json ，有的字段标注非必填。按照我的理解，非必填那就传 null ，结果错！人家的意思是连字段名都不传。不知道他们用的什么开发，是不是很难兼容两种情况，反正我的项目是能轻易兼容的。
总的来说也不是什么大问题，但是总在不应该有的小问题上给你整活儿就很讨厌。
1. 命名风格不统一
同一个接口，一个字段命名为 xxxid ，另一个为 xxx_id 。大概他们自己也觉得蠢，在下一个版本的接口中统一为 xxxid 。
2. 描述清
一个字段描述是需要随机字符串，没有说明任何字符限制。按照字面理解，我传 random ascii ，结果错！只好老实按照他给的示例值 字母 + 数字 生成，至今不知道是不是做了这个字符限制，懒得再试其它字符。
3. 描述不清 2
接口需要传 json ，有的字段标注非必填。按照我的理解，非必填那就传 null ，结果错！人家的意思是连字段名都不传。不知道他们用的什么开发，是不是很难兼容两种情况，反正我的项目是能轻易兼容的。
总的来说也不是什么大问题，但是总在不应该有的小问题上给你整活儿就很讨厌。
 | 1 PerFectTime 2021-10-28 11:25:59 +08:00 文档烂到不能再烂 +10086 字段名很傻，很讨厌一会下划线，一会儿连词，驼峰都没有 |
 | 2 kohoh 2021-10-28 11:50:14 +08:00 有同感 |
 | 3 kop1989 2021-10-28 12:13:29 +08:00  3 明明一些字段说明可以放在 api 当页的（并不复杂），但非要你跳转到某个业务的详细介绍页，让你去一大段文字里去挑那个字段的说明和要求。 |
 | 4 devld 2021-10-28 12:27:56 +08:00 via Android 1 对比微软、Google ，同样是大厂，但就是感觉国内的乱糟糟的，一点都不优雅 |
 | 5 jdhao 2021-10-28 12:31:12 +08:00 via Android 能跑就行.jpg |
 | 6 maypu 2021-10-28 12:37:27 +08:00 更离谱的是，这还是优化后的，几年前的更烂。。。 |
 | 7 hahasong 2021-10-28 12:39:13 +08:00 小聋：你在教我做事 |
 | 8 jr55475f112iz2tu 2021-10-28 12:44:22 +08:00 毕竟是 “小而美” |
 | 9 uCharles 2021-10-28 13:42:15 +08:00 1 公司现在在用企业微信，怂恿改成钉钉中。。。 |
 | 10 Wenco 2021-10-28 13:43:34 +08:00 headimgurl |
 | 11 xlsepiphone 2021-10-28 13:46:58 +08:00 @sugz #9 钉钉的 bot 和企业微信的 bot 哪个好用？ |
 | 12 Williamwang 2021-10-28 13:51:08 +08:00 @sugz #9 怎么不用飞书哈哈哈 |
| 14 uCharles 2021-10-28 14:11:46 +08:00 |
 | 15 Kaier 2021-10-28 14:13:42 +08:00 1 勇敢一点, 把 听闻 这 2 个字给去了. XD |
 | 16 mason961125 2021-10-28 14:16:01 +08:00 1 去看看微信支付每个接口的 **公共错误码** 你会有新的认知。 |
 | 17 HappyFox 2021-10-28 14:22:46 +08:00 @sugz #14 个人之见，国内使用人数超过十万的办公软件中，面向老板思维的是钉钉，面向运营揽客的是企业微信，飞书是唯一一款面向员工的办公软件，不管是文档、机器人还是开放接口，都用起来很顺手。 当然，如果公司在国外，可以试试 slack 、谷歌全家桶之类的，各有各的优势，适合自家企业文化就好。 |
 | 19 wangsfox 2021-10-28 15:08:00 +08:00 又不是不能用.jpg |
 | 20 nziming 2021-10-28 15:12:39 +08:00 可以说 微信开发者文档说非常差了（最近开发有感） |
 | 21 NPC666 2021-10-28 15:13:51 +08:00 via Android 张小，你__什么时候__啊 |
 | 22 jadehare 2021-10-28 15:17:17 +08:00 两三年前看过，具体细节不记得了，但是就记得需求经常变动，隔俩版本可能就要不同的实现方式了 |
 | 23 ChillyPrince 2021-10-28 15:18:37 +08:00 1 说白了国内就没啥工程师文化，都是 KPI 逼的 |
 | 24 tty1 2021-10-28 15:20:58 +08:00 国内认真做的很少 |
| 25 ktqFDx9m2Bvfq3y4 2021-10-28 15:32:44 +08:00 先不要说开发文档，你看看注册它的各种平台用了多少个邮箱。。。 |
 | 26 ReferenceE 2021-10-28 15:34:42 +08:00 via Android 不用"听闻"... |
 | 27 suzic 2021-10-28 16:02:49 +08:00 via Android 文档烂，账号系统烂，api 烂，产品也烂！ |
 | 28 ZRS 2021-10-28 16:20:10 +08:00 via iPhone 确实垃圾 |
 | 29 docx 2021-10-28 16:25:20 +08:00 百度也是，之前用他们的接口识图，有的传入 base64 json ，有的直接传 base64 text ，有的 base64 要去掉文件头…… 关键在文档里也不区别说明。 |
 | 31 azhangbing 2021-10-28 16:33:09 +08:00 微信本身就很烂。。耗电 占内存 卡等等 |
 | 32 xloger 2021-10-28 17:40:39 +08:00 微信，QQ ，微博的分享 SDK ，我记得有一家的文档，代码甚至是截图 |
 | 33 z42514 2021-10-28 17:55:16 +08:00 确实很烂，我之前对接支付的时候，发现他们不同平台字段名还不一样的....... |
 | 34 joesonw 2021-10-28 17:55:42 +08:00 @xlsepiphone 请不要侮辱 bot, 都只是一个 webhook. 能 @机器人 出发操作的才是 bot. |
 | 35 zhady009 2021-10-28 17:59:04 +08:00 微信服务端的 api 文档还有字段打错的 查了半天才从网上找到正确的参数名.. |
 | 36 wang48ql 2021-10-28 17:59:15 +08:00 接过微信的登录、支付，也接过支付宝的支付，文档是真的烂，两个相对而言的话，支付宝稍微好一点， 国内巨头对开发者生态真的是太不重视了 |
 | 37 ZeroDu 2021-10-28 18:20:42 +08:00 大公司里面最烂了，没有之一。各种服务，包括微信支付连 sdk 都没有 |
 | 39 leon0918 2021-10-28 19:36:53 +08:00 感觉已经不更新了，推出的人拿足了奖金，没有动力了 |
 | 40 tudou01 2021-10-28 20:03:51 +08:00 via iPhone 飞书天下第一 |
 | 41 Ansen 2021-10-28 20:49:00 +08:00 同一个产品的，CURD 接口，id 这个字段，一些是 int 一些是 string ，神烦 |
 | 42 pengtdyd 2021-10-28 21:12:03 +08:00 微信：爱用不用！！！ |
 | 43 LimboRunner 2021-10-28 21:51:50 +08:00 前段时间被微信支付的接口折磨的不行，报错驴唇不对马嘴，全靠猜，字段一会儿大写一会儿小写，全靠试。 不做不知道，一做才发现，腾讯这种大厂跟我们小作坊的水平其实差不多嘛。 狗屎一样的文档，我也能写的这么烂。 |
 | 44 xylxAdai 2021-10-28 23:48:16 +08:00 之前我也骂，现在进来才发现，微信的开发人员相比它的用户体量来说实在太小了，小的可怜。。 好像是这边比较强调精兵，小团队作战，开发者文档估计就几个人在维护，能及时更新就不错了，其他的，真的没办法的。。 |
 | 45 ppphp 2021-10-28 23:52:14 +08:00 就是由于某种原因，国内 im 市场缺乏竞争，国外像苹果，谷歌广告这种约等于垄断的平台，文档也很差 |
 | 46 mikuazusa 2021-10-29 00:10:37 +08:00 阿里云和钉钉的文档更烂 |
 | 47 Bijiabo 2021-10-29 00:37:36 +08:00 4 连微信的文档都嫌弃，遇到阿里云的文档岂不是要杀人 |
 | 48 redford42 2021-10-29 01:26:27 +08:00 微信、钉钉、飞书、welink 四家都对接过 怎么说呢.... 微信：企业微信创建部门的接口部门 id 传负数会报错 钉钉：今天刚发现钉钉悄悄改了部门下名称已重复的 errCode ，是的改了 code ，没有更新文档 飞书：更新特别快，深度合作，产品经理说的一个功能，代码已经上线了，文档没更新 welink：emmmm 对外蓝色对内红色，蓝色 bug 多的不行 |
 | 49 fan123199 2021-10-29 01:48:32 +08:00 很烂，很难受，页面看起来是我要的内容，看是看完感觉还是不会用，基本是要找论坛才到看到能用的教程。 |
 | 50 sytnishizuiai 2021-10-29 02:17:13 +08:00 @Bijiabo #46 哈哈，赞同。感同身受。 |
 | 51 justfindu 2021-10-29 08:56:54 +08:00 你要有对比才知道, 微信已经是好的了 |
 | 52 constantine008 2021-10-29 09:00:49 +08:00 |
 | 53/span> zhea55 2021-10-29 09:05:40 +08:00 小程序的部分接口，居然要发布生产环境，才能生成跳转小程序的链接。 连个测试环境都没有。 见怪不怪了。 |
 | 54 zhw2590582 2021-10-29 09:10:16 +08:00 小程序登录接口和网页二维码登录接口获取的用户信息字段不一样，也不知道为什么这样搞 |
 | 55 Jaosn 2021-10-29 09:27:30 +08:00 还记得一天晚上和后端一起调试支付的情景 |
 | 56 cheng6563 2021-10-29 09:28:55 +08:00 企业微信更差 |
 | 57 TomVista 2021-10-29 09:31:35 +08:00 请你不要侮辱 文档差 这三个字 |
 | 58 g0thic 2021-10-29 09:35:26 +08:00 虽然微信的开发文档很差，但是已经是国内大厂里综合做的最好的了 |
| 59 ZeroDu 2021-10-29 09:37:58 +08:00 相对来说支付宝的文档就很好了，比如支付还有沙箱模式 |
 | 60 24match 2021-10-29 09:42:55 +08:00 每次反复看都不能看出个所以然 |
 | 61 pkoukk 2021-10-29 09:44:03 +08:00 还行吧，我的要求不高，示例跑的通就行 |
 | 62 hzder 2021-10-29 10:20:26 +08:00 最近刚对接过微信。。确实烂，妈的 |
 | 63 lwldcr 2021-10-29 10:20:44 +08:00 大家都一样烂 就不要比较了 我项目里用到的字节的巨量引擎文档 * 字段类型标注里整数型用到了```number```，```int```，老老实实写个 int/int32/int64 能死，你项目后端本身不就是 go 实现的，用 go 的类型定义不就行了 * 还是类型说明，对于嵌套类型，有些直接写个```json```,， 有些直接写个```json[]```，还有些写的是```object```, ```object[]``` 一开始还想反馈一下纠错的，后来发现太多了就懒得弄了，所有整数型直接```int64```，所有自定义类型直接按全字段定义 |
 | 64 skinny 2021-10-29 10:49:26 +08:00 烂，各种返回描述含糊不清，甚至压根没有，让你实际执行再去看返回，然而你测试也需要先申请相关服务，没法根据文档直接开写，你即便申请好了相关服务，因为文档烂，你还是得搜索别人的代码看别人踩过的坑，不然你不小心就运行不了。 还有各种数据长度大小限制也不说，言辞之间好像随时会变，实际又很多年没有变，设计数据库时写个列限制都没法写。 |
| 65 skinny 2021-10-29 10:51:20 +08:00 还有有的字段到底可以填什么也不写清楚，同一个 API 不同页面的说法不一样，还得看别人踩过的坑才能知道到底怎么写。 |
 | 66 anzu OP 又发现一个，同一个字段在不同接口的长度限制不一样...我暂且取交集得了 |
 | 67 legiorange 2021-10-29 11:02:05 +08:00 被微信支付和微信小程序文档劝退，已完全放弃微信端开发…… |
 | 68 lskjdfgl 2021-11-02 09:51:40 +08:00 还有一个，也不知道那个王八蛋写的 [字符串] 不适用于汉字 |
Select Language