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