听闻微信开发者文档很差

[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]

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