这是一个创建于 1109 天前的主题，其中的信息可能已经有所发展或是发生改变。
实际试过之后才知道有多烂
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
czfy 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
Chad0000 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
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