听闻微信开发者文档很差

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

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

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

总的来说也不是什么大问题，但是总在不应该有的小问题上给你整活儿就很讨厌。
6750 次点击
所在节点    微信
68 条回复
NPC666
2021-10-28 15:13:51 +08:00
张小🐲，你__什么时候__啊
jadehare
2021-10-28 15:17:17 +08:00
两三年前看过，具体细节不记得了，但是就记得需求经常变动，隔俩版本可能就要不同的实现方式了
ChillyPrince
2021-10-28 15:18:37 +08:00
说白了国内就没啥工程师文化，都是 KPI 逼的
tty1
2021-10-28 15:20:58 +08:00
国内认真做的很少
Chad0000
2021-10-28 15:32:44 +08:00
先不要说开发文档，你看看注册它的各种平台用了多少个邮箱。。。
ReferenceE
2021-10-28 15:34:42 +08:00
不用"听闻"...
suzic
2021-10-28 16:02:49 +08:00
文档烂，账号系统烂，api 烂，产品也烂！
ZRS
2021-10-28 16:20:10 +08:00
确实垃圾
docx
2021-10-28 16:25:20 +08:00
百度也是，之前用他们的接口识图，有的传入 base64 json ，有的直接传 base64 text ，有的 base64 要去掉文件头……
关键在文档里也不区别说明。
docx
2021-10-28 16:26:13 +08:00
@suzic #27 瞎说什么，这叫小而美
azhangbing
2021-10-28 16:33:09 +08:00
微信本身就很烂。。耗电 占内存 卡等等
xloger
2021-10-28 17:40:39 +08:00
微信，QQ ，微博的分享 SDK ，我记得有一家的文档，代码甚至是截图
z42514
2021-10-28 17:55:16 +08:00
确实很烂，我之前对接支付的时候，发现他们不同平台字段名还不一样的.......
joesonw
2021-10-28 17:55:42 +08:00
@xlsepiphone 请不要侮辱 bot, 都只是一个 webhook. 能 @机器人 出发操作的才是 bot.
zhady009
2021-10-28 17:59:04 +08:00
微信服务端的 api 文档还有字段打错的 查了半天才从网上找到正确的参数名..
wang48ql
2021-10-28 17:59:15 +08:00
接过微信的登录、支付，也接过支付宝的支付，文档是真的烂，两个相对而言的话，支付宝稍微好一点，
国内巨头对开发者生态真的是太不重视了
ZeroDu
2021-10-28 18:20:42 +08:00
大公司里面最烂了，没有之一。各种服务，包括微信支付连 sdk 都没有
ncepuzs
2021-10-28 19:29:07 +08:00
@Chad0000 #25 确实，微信、微信公众号和微信开放平台不允许使用同一个邮箱……
leon0918
2021-10-28 19:36:53 +08:00
感觉已经不更新了，推出的人拿足了奖金，没有动力了
tudou01
2021-10-28 20:03:51 +08:00
飞书天下第一

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

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

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

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

© 2021 V2EX