这是一个创建于 1874 天前的主题，其中的信息可能已经有所发展或是发生改变。
需要发送一些报警信息，用到机器人接口。
用过钉钉、企业微信的 机器人， 今天接入了下 slack 的，发现有很大的区别。
slack api 真的很详细，包含消息的格式，支持什么消息，文本最大长度，emoj 等等，还有消息工具可以调试。
钉钉、企业微信的接口不要太简单，记得之前想知道 钉钉最大能发多大消息，还要自己试， 支不支持换行什么的
也需要各种尝试。
真的是，不是网络问题，slack 彩虹屁可以吹爆。
国内的为什么会这样，不管公司大小，都是利益至上，都不用心做产品吗？
用过钉钉、企业微信的 机器人， 今天接入了下 slack 的，发现有很大的区别。
slack api 真的很详细，包含消息的格式，支持什么消息，文本最大长度，emoj 等等，还有消息工具可以调试。
钉钉、企业微信的接口不要太简单，记得之前想知道 钉钉最大能发多大消息，还要自己试， 支不支持换行什么的
也需要各种尝试。
真的是，不是网络问题，slack 彩虹屁可以吹爆。
国内的为什么会这样，不管公司大小，都是利益至上，都不用心做产品吗？
第 1 条附言 · 2019-09-25 12:49:39 +08:00
 |
1
damngood 2019-09-24 18:28:41 +08:00  2
国外很多公司的 API 文档都是这样的... 记得当年第一次对接 Stripe API 之前还没有觉得国内大厂 API 有多烂..
|
 |
2
lululau 2019-09-24 18:30:33 +08:00 via iPhone
看阿里云的文档，觉得阿里的还行啊，腾讯的文档真是呵呵了
|
 |
3
taogen 2019-09-24 18:36:02 +08:00 via Android
财迷心窍，上行下效。
|
 |
5
Varobjs OP @taogen 不过也能理解，周边同事包括自己，很多时候就是完成当前任务，优化东西，一不被任何，二很多情况 leader 也不许
|
 |
6
tmackan 2019-09-24 18:41:33 +08:00
接触过 Trello, zappier
zappier 简直牛逼，各个 app 上可以联动 |
 |
8
kuroismith 2019-09-24 19:38:46 +08:00 1
是这样的, 面向逆向编程
|
 |
9
ChristopherWu 2019-09-24 19:40:06 +08:00 2
因为。。在国内你接 api 是你求他们。。。
|
 |
10
chendy 2019-09-24 19:43:48 +08:00
可能因为国内重视这方面比较晚（或者到现在也不怎么重视吧）
|
|
11
Varobjs OP @ChristopherWu 真相
|
 |
12
sikariba 2019-09-24 19:48:53 +08:00
我也有类似经历，先写了 slack 感慨这文档写得真是好啊，后来要对接微信，文档版本太旧还给我挖了个坑，最后还是靠百度解决的
|
 |
13
pcbl 2019-09-24 19:55:26 +08:00 via Android
微信支付之前的文档确实差一不小心就进坑，还好用的人多基本上你遇到的别人都遇到过。
这两天搞 tg 机器人感觉 api 也很好，交互处理很方便。 |
 |
14
jinliming2 2019-09-24 19:57:31 +08:00 via iPhone
@lululau 阿里云的文档我记得之前看帖子说是直接照搬 AWS 的文档
|
|
15
Varobjs OP @pcbl 既然那么多人都踩过坑了，百度都能收到，微信都不更新温度，只能说明，国内根本不重视 文档啊
|
|
16
Varobjs OP 收到 - 搜到
温度 - 文档 😭 |
|
17
pcbl 2019-09-24 20:03:00 +08:00 via Android
@Varobjs 确实不重视，或者说有点混乱，有时候新旧文档和 sdk 或者 demo 相互穿插，你还得自己猜测到底是文档太新了还是代码太旧了。
|
 |
18
agdhole 2019-09-24 20:15:22 +08:00 1
国内应用给你开 api 都烧高香了，人人都要搞封闭，生怕别人接入做第三方去了
|
 |
19
realkenshinji 2019-09-24 20:16:19 +08:00 via iPhone
@damngood stripe 的 api 文档算是典范了
|
 |
20
ClericPy 2019-09-24 20:22:03 +08:00
国外独角兽企业的 api 好看+好用的不得了, Intercom 除外...
|
 |
21
ltm 2019-09-24 20:22:25 +08:00 2
当造了一个墙以后，墙里没有竞争，就开始有恃无恐的堕落发展了
自由竞争才能创造更多福利（各个方面） |
 |
22
asuka02 2019-09-24 20:34:30 +08:00 via iPhone
最近对接小爱同学，小米的文档写的一头雾水。有问题只能提工单回复全看运气。之前申请小米开发者说是两个工作日审核，结果等了十天没反应，发邮件一个月后才回复。审核通过又不发邮件或者短信提醒⏰
|
|
23
Varobjs OP |
|
24
Varobjs OP 以上，有回复是因为利益相关，要是免费的东西，估计没人鸟你
|
 |
25
2oTp 2019-09-24 20:57:43 +08:00
我们是社会主义初级阶段, 发展还没跟上, 要慢慢来, 等个 100 年或许就有了
|
 |
26
justfortest 2019-09-24 21:09:13 +08:00
国内大部分公司风气就是这样，而且行业真的太浮躁了。
|
 |
27
azh7138m 2019-09-24 21:27:46 +08:00
@lululau 阿里云的文档的文档也是有点烂的，气到昏厥，国外大厂哪个文档不必他强。apiVersion 那个设计蠢的要死，参数类型不对，mock 数据的问题也不说了，示例值和默认值不一样也坑到我了，一言难尽。
|
 |
28
avalon0624 2019-09-24 21:33:17 +08:00 1
写完就完成任务了，怎么会理解看文档的人的感受
|
 |
29
ranwu 2019-09-24 21:35:48 +08:00 via iPhone
没利益，不做
|
|
30
Varobjs OP 1
@justfortest 是太浮躁了，老板要的是，想法提出来，就要立刻、马上实现。产品经理是为老板服务。至于其他，“先实现，后面再优化” 听太多了， 结果，大部分情况是，后面自己都不想看自己代码。
|
|
31
justfortest 2019-09-24 21:50:18 +08:00
@Varobjs 项目经理和产品也都是一个样，各种细节和功能在开发过程中一改再改，本来就紧凑的时间就更少了，代码质量项目架构、需求文档、设计文档、接口文档也就无从谈起了，我是没见过有完善文档的项目。
|
 |
32
imycc 2019-09-25 05:45:55 +08:00
听了老哥们推荐的 Stripe API 文档，过去瞄了一眼确实做得非常好看了，结构清晰，交互形式也挺新颖的，值得学习。
我之前工作包含了维护一个内部平台的 API，编写 API 文档。我的问题是： 1. 谁来负责写文档。编写 API 文档是个技术活，编写的人既要懂业务，又要有良好的表达能力。 2. 以何种形式来呈现文档。md 文档简单但是缺少交互能力，带有交互设计的文档又依赖人去设计跟开发。 3. 文档变更缺少规范。理论上接口的变动也要同期更新文档，才算是一个完整的更新流程。 但是最终一个问题，还是缺乏驱动力。如果编写优秀的 API 文档能成为一项“成果”，我相信开发者维护的动力会更强。但以我之前的经验来说，大多数时候是用爱发电。 还有，我觉得缺少了编写标准跟编辑平台。Swagger 那种看起来还行，但是丑，而且编辑有点麻烦，且不能集成对业务逻辑的描述，自由度我感觉不太行（也有可能是我了解不够深） |
|
33
Varobjs OP @imycc 相信大部分人都有这种疑问，
今天也去看下这个文档，如果哪里有分享他们是如何维护的就更好了 |
 |
34
a852695 2019-09-25 09:28:55 +08:00
阿里云的短信接口文档和 demo 代码对不上就算了，提供的 SDK 库还是老的，害得我调试了老半天，你说 SDK 都是旧版本这让人怎么用，还好熟悉 Python，能改改 SDK，凑合能用，我都不相信是阿里云的人写的
|
 |
35
arrow8899 2019-09-25 09:57:05 +08:00
@Varobjs The format and style is borrowed (with permission) from the CoffeeScript documentation, but the software generating the documentation was built in-house.
|
 |
36
ytmsdy 2019-09-25 11:05:55 +08:00
现在阿里云 oss 的 python sdk 库现在还有 bug，现在能用的库都是第三方写的。
|
 |
37
exip 2019-09-25 13:24:02 +08:00 via Android
从"无"到"有"是一个很大的成绩,大家都关注,从"有"到"好用"基本没人关注,做的再好也是这样.
|
 |
38
Sasasu 2019-09-25 14:11:56 +08:00
google 的 api 就烂的很，给你一堆从 protobuf 上生成出来的东西，还不如直接去读那一堆 proto 文件。
|
Select Language