1. 聚能聊>
  2. 话题详情

一个好的 SDK/API应该为开发者提供哪些便利?

       在新一波的创业公司中,不乏通过SDK或API的方式获取用户,不仅可以为千万的APP服务,还能进一步关联每个APP的用户。根据个推调研发布的数据,SDK可以服务百亿级用户。Chinapex预测,到2018年,API经济将成为一个2.2万亿美元的全球市场。因此相比于APP,SDK/API这种方式的效率更高,成本更低。

       传统行业也意识到API的重要性,用API开放服务整合线上、线下资源,成功转型互联网+。比如银行允许第三方在钱包实现快捷支付、12306供第三方的票务查询、交通局的违章查询等都是通过API来提供的。                   

timg

       而做为阿里云的用户,除了常规在控制台里使用云计算产品以外,越来越多的开发者开始直接通过阿里云SDK/API来使用云产品,开始将跨平台、无状态的API用来作为系统间创建联系的通道,以消除前期系统建设的信息孤岛,从而降低协同成本,提升利润空间。

但是很多开发者也反馈,使用阿里云SDK/API的时候,也遇到了各种各样的坑。

      小A觉得文档不够细化,很难读懂;

      小B觉得API错误信息太笼统;

      小C觉得SDK每个接口可调用次数不明确;

      小D认为SDK/API没有统一规范;

      小E又认为接口定义不够准确。

等等……


做为开发者,你在使用阿里云SDK/API时,都遇到了哪些糟心的问题?

你觉得阿里云SDK/API目前存在的最大问题是什么?有哪些点是需要重点提升的?


若你在使用阿里云SDK/API也有类似不爽的体验,请来我们的“吐槽大会”,尽情吐槽,阿里云在聆听。

所有的吐槽,在我们眼里都是一条条宝贵的建议,我们会确保一条条跟进落实。每条优质吐槽都可以获得我们的奖励。另外,特别优质的“吐槽”,将会有额外神秘大奖哟~

参与话题

奖品区域 活动规则 活动已结束,可继续参与讨论哦

  • 奖品一

    优酷VIP季卡 x 3

  • 奖品二

    定制笔记本 x 1

  • 奖品三

    技术新书 x 2

66个回答

2

alex03 已获得技术新书

几个槽点:
1,在官网上找不到整个API的搜索入口。
2,经常在搜索不到API 错误的解决方案。
3,查询单产品的API的入口很深,很难找到。

仙游 回复

感谢亲的反馈,已提交给产品跟进

仙游 回复

错误码查询已经发布:可参考:https://help.aliyun.com/document_detail/53438.html?

评论
1

福星布布 已获得定制笔记本

我之前搜索过一些报错的错误码解释说明,发现竟然有人和我一样来云栖社区问,按理说这些错误码的解释应该在阿里云官网中就能找到,为什么没有提供,产品漏掉了吗?还有在控制台上操作的时候,发现报错的提示有中文也有英文,感觉分别在两个国家。

仙游 回复

感谢亲的反馈,会提交给相关产品团队进行完善。

仙游 回复

错误码查询已经发布:可参考:https://help.aliyun.com/document_detail/53438.html?

评论
2

cckankan 已获得优酷VIP季卡

一个很小的槽点:API的帮助文档中,API的名称用的是中文。。。。比如这个https://help.aliyun.com/document_detail/26297.html 而我代码里面都是英文名称,靠API英文名称找到对应中文帮助有点耗时。

仙游 回复

感谢亲的反馈,已提交给产品跟进

评论
1

1002102338322250 已获得优酷VIP季卡

面向开发者的API资源的整合,包括API的使用引导、示例、错误码信息、相关工具等等,如果能够再详细具体点就更好了

仙游 回复

错误码查询也已经发布:可参考:https://help.aliyun.com/document_detail/53438.html?

评论
0

浮生递归 已获得优酷VIP季卡

用过SDK.API之后才会知道这东西有多少爽。只是并不是每一个api都这样那么尽如人意,大部分都有这样那样的缺点。比如文档不够完整,案例不够详细,版本不够丰富等等。
举个例子,阿里云的短信服务的api版本就是没有asp语言的。这个语言比较古老,现在用的不多,所以还能理解。但是c#版本居然只有开发客户端的c#版本,没有开发web端的c#版本。之前我测试的时候没有注意,结果在那里调试了一整天都没成。最后发现是版本的问题,然后去网上找了一个别的正确的版本,几分钟就搞定了。
增加一个语言版本,也不会增加特别多的成本吧?为什么不每个语言全部来一套呢?

阿里云推出api市场也相当不错,很多高端功能都非常便宜,各种一分钱多少次。就小项目而言是非常重大的利好消息。但是因为是第三方提供商,似乎质量和售后不一定能保证,这个是跟官方自营api最大的区别。

季卡季卡季卡…

巴洛克上校 回复

你是啥贵你要啥啊

浮生递归 回复

这是体现劳动价值啊(实际上是有朋友--女的--想要,我自己包年了,没需求)

评论
1

lightseeker

整体来说,面向开发者的API资源没有充分的整合,包括API的使用引导、示例、错误码信息、相关工具等等,都分散在帮助文档的各个角落。在需要跨产品开发查询哪些API可用时,在调试API报错查询分析报错原因时,都缺乏这样的开发者专区提供解决方案。

仙游 回复

谢谢亲的反馈,已经提交给产品团队跟进优化

仙游 回复

错误码查询也已经发布:可参考:https://help.aliyun.com/document_detail/53438.html?

评论
0

1330802089200826

对于开发者来说,API/SDK可以帮助开发者快速熟悉要使用的服务,尤其对于初次接触的开发者。阿里云的API感觉总得来说不错,但是我好像没有找到一个完整的针对不同语言的的API,对于视频教学,没有找到收藏的,第一次好不容易找到了,下次进来又得找半天。

仙游 回复

谢谢亲的反馈,已经把相关问题提交给产品团队跟进优化

仙游 回复

没有找到一个完整的针对不同语言的的API,对于视频教学,没有找到收藏的,第一次好不容易找到了,下次进来又得找半天。
这个情况能详细的描述一下需求点与使用场景吗,以便于我们更方便的进行问题排查解决。

评论
1

巴洛克上校

为了你的问题我去不常点开的页面看了看,阿里云自家SDK/API目前来看还挺不错的有的有视频 ,还有示例和相关的文档和用于测试的工具,还算全面,值得肯定的是在复杂的sdk或者aip还配有阿里云大学的教程很好,因为没深入去使用暂时没发现什么缺陷BUG之类的问题,就是缺少个客服或者在线技术顾问,在我感觉配个顾问还是有必要的,哪怕是配个常见问题及其解决办也是好的,后续问题等我有时间深入了解后提交到聆听平台!

送个笔记本,或者季卡都好哈哈!

rolitter 回复

怎么哪里都有你,你不用上班?天天靠着这些奖品生活????

仙游 回复

抱歉,下次评论了再给吧,本次礼品比较少,已经发放完毕。

巴洛克上校 回复
回复@仙游:

木事,木事,谁提的建议好给谁哈哈~~~

评论
1

1655201999502527

首次使用阿里的服务,一直觉得阿里做的挺不错,所以开始尝试使用阿里所提供的服务,希望可以又不一样的体验

仙游 回复

加油

评论
2

shawn.ss

骗奖品了,新书新书
个人觉得所有折腾过的api当中,数阿里云的文档和样例最全最严谨了,(不服且有兴趣的去研究下微信的文档和样例,2000+的实习生写出来的水平),尤其是oss的文档,最佳实践部分很赞,
不过过于详细的文档也会给人一种信息海洋的感觉,对于某些急客,出一个cheat sheet式的快速上手指南也许也很不错,当然阿里云目前有这个栏目,但是还是冗余信息很多,一般都好几页,最好找一页文档,就说最简单的怎么弄就好,细节展开统统不要,只要主线,这样可能会吸引更急脾气的家伙来折腾。
实话说,写长了费劲,写短了费脑,优化空间还是有的

月啊月啊 回复

急客一般喜欢下载案例,换掉案例里的id,key就可以上线了,嘿嘿

shawn.ss 回复

是,好多连代码都不看直接用

评论
0

九口音

API确实好,但是很多API都是有政策限制或者接入企业级限制,备案限制,要是个人限制少点就好了

仙游 回复

这个要看产品,每个产品不同。比如像域名认证,备案,这些都是工信部以及老花镜注册局的要求,因为他们的接口,调用的服务商多,如果不限制,随便被调用,若出现恶劣行为故意调用,把接口弄挂了,这个影响就会比较大了。

评论
0

1241702364998557

面向开发者的API资源没有充分的整合,包括API的使用引导、示例、错误码信息、相关工具等等,都分散在帮助文档的各个角落。在需要跨产品开发查询哪些API可用时,在调试API报错查询分析报错原因时,都缺乏这样的开发者专区提供解决方案。

仙游 回复

感谢亲的反馈,API相关问题我们已经在进行优化中,错误码的梳理文档,已经上线了,可以参考一下https://help.aliyun.com/document_detail/53438.html

评论
0

云居山

阿里云服务器怎么使用啊?求助

仙游 回复
评论
0

cocoma1984

似乎现在没有一个全部的聚合页,可以让开发者找到所有阿里相关的API,包括阿里云自己的(一方)、阿里集团的(二方)、云市场里的(三方)。API需要共享才能发挥更大的商业价值。

仙游 回复

聚合页是有的,https://develop.aliyun.com/tools 可能不够明显,我们已经在加强完善中。敬请期待。
错误码查询也已经发布:可参考:https://help.aliyun.com/document_detail/53438.html?

评论
0

1439834529883137

开放sdk是为了更好的共享,自私的企业是没有发展的……

仙游 回复

哈哈

评论
0

冥想伊甸园

我是个菜鸟,可能API,有具体的实例更好!!!

仙游 回复

亲具体 需要一些什么样的实例场景 ,大部分都是有示例的

评论
1

境界里

我提出一个建议:为别人提供的SDK,应尽可能降低对开发工具的版本、依赖的其他SDK的版本的要求,特别是客户端的开发。举例说明:阿里云的OTS表格存储的C++语言的SDK,提供出来的运行库只有for CentOS的,代码是基于C++11的,编译环境还要去实用Scons。我理解这个SDK,只是方便了阿里云的开发人员,他们可以用他们熟悉的语言、代码、开发工具来做,全然没有考虑用户的需求。尤其是当用于客户端时,为了兼容的需要,客户端开发时要尽量降低开发环境的版本,以免最后安装包在旧版本的操作系统上进行安装时,还要依赖一大堆高版本的运行时库,甚至要要求客户升级操作系统!这必须要吐槽一下!

1

28063099

做好对传统行业API的服务,把他们的API开放与整合搞好,线上、线下资源高效融合,助力其转型互联网+。

0

1556502215539042

还好

不错呀 回复

不错一

评论
0

1089587303202032

好好学习

不错呀 回复

天天向上

评论
4
4127
浏览
0
收藏
邀请他人互动
关注
9
粉丝
71
话题
11

简介:

阿里云产品运营专家,深耕于互联网企业应用领域长达8年,先后负责阿里云企业应用产品的底层架构搭建、阿里云网络产品的改进运营、视频云产品与API网关的规划及运营。目前主要负责阿里云产品的用户体验运营。
API 网关(API Gateway),提供高性能、高可用的 API 托管服务,帮助用户对外开放其部署在 ECS...

一站式提供企业即时通讯、销售管理、协同办公。

一个稳定可靠的集中式访问控制服务。您可以通过访问控制将阿里云资源的访问及管理权限分配给您的企业成员或合作伙伴。

为您提供简单高效、处理能力可弹性伸缩的计算服务,帮助您快速构建更稳定、安全的应用,提升运维效率,降低 IT 成本...