建设开发者生态:6项华为API管理原则落地
摘要: 为了向开发者提供良好、一致、稳定的华为API的体验,华为通过明确“API管理六项原则”,来支持开发者生态建设。
一个不开放的组织,会慢慢成为一潭僵水,一个封闭的系统,能量最终会耗尽,在产品开发上,同样需要开放,需紧紧围绕业务架构,在业务层面走向开放,并不是什么都去做,而是能激活别人来做。在行业数字化转型中,不少领头羊的企业在构筑联接、云、大数据、人工智能等方面的竞争力的同时,也在利用技术、数据、资本等各种手段吸引和获取垂直行业的优质生态资源,通过能力开放,吸引更多的开发者参与生态建设。
平台在企业内部走向开放的同时,也需要进一步向生态开放,支持企业的生态布局。即产品和平台通过开放的应用编程接口(Application Programming Interface,API)的方式对外开放能力,生态中的开发者利用该API,将其上层应用与开放的能力融合,构建差异化的创新解决方案,助力企业客户数字化转型和商业成功。
为了向开发者提供良好、一致、稳定的华为API的体验,华为通过明确“API管理六项原则”,来支持开发者生态建设。
1、 价值原则:制定明确的可衡量的API价值指标,牵引价值提升。
2、 稳定性原则:通过API版本管理,避免和减少对开发者的影响,保证API稳定性。
3、 易用性原则:API设计要面向开发者,提供从学习、开发到应用发布全过程的良好体验。
4、 安全性原则:制定API相关的风险控制措施以保护数据和监控访问。
5、 一致性原则:API应按统一的格式规范、发布渠道对外呈现,以保持一致的开发者体验。
6、 服务支持原则:遵循统一的流程规范,为开发者提供良好的服务支持。
华为通过在产品和平台落地“API管理六项原则”,为生态中的开发者应用API时提供良好的体验,有效支持了开发者生态建设、企业客户数字化转型和公司云化战略落地。——节选自《从偶然到必然:华为研发投资与管理实践》
面向开发者,华为云提供了完整的系列工具集和服务,支持API全生命周期的管理:
华为云自身的服务,以及合作伙伴的服务,通过API网关对外提供;
API网关负责API的管理、分发、流控、缓存、监控以及SDK和CLI的生成;
对外提供的API,可以在API Explorer进行查询和调试,也可以进行API编排,同时也可以在云市场API专区进行直接交易;
与此同时,华为云提供全系列的工具,支持API的设计、开发、测试以及发布的全流程管理。
从华为云官网开发者资源工具下的API Explorer,可以获取华为云开放的2800+的API信息。这里汇聚了华为云服务所有开放的API,大家可以在这个平台上快速的查看和搜索、查看API文档、随时搜索API错误码,我们同时提供了在线可视化调试的功能,方便学习和掌握API的使用。
API Explorer的关键能力,首先是支持开放API的在线检索和可视化调试,可以定位到云服务,快速查询云服务下所有开放API;选择API后,通过填写参数,可以直接进行在线调试,可以直接查看API的调用返回结果。
通过API文档可以获取更详尽的信息,包括接口约束、请求参数说明、示例、返回参数以及SDK等非常全的信息。我们调用接口返回的错误码,可以通过错误码中心,快速找到对应的错误详细信息以及处理措施建议,快速解决API调用出现的问题。
另一个关键能力是代码示例,支持Java、Python、Go、C#等主流语言调用SDK来访问华为云开放API;同时支持CLI调用API,在安装部署、变更升级、扩容等场景下,可以使用命令行、批处理的方式来操作。华为云提供了不同OS(Windows、Linux、MacOS等)下的CLI工具,支持依据用户填写的参数来快速生成CLI命令,来操作华为云的开放API。
想要获取更多关于华为云API信息?
“免费下载创新加速利器《华为云API精选手册》。
华为云API精选手册(第一期刊).pdf 4.18MB
—— 活动推荐 ——
华为云已经成为全球主要云服务供应商,在华为云上开放了2400+ API,包括计算、存储、网络、应用服务、软件开发服务、视频、数据库、EI智能等74+产品,如何利用这些丰富强大的API快速开发自己的应用和服务,成为大家关注的热点。
华为云API学习赛,为入门初学者量身定制的学习平台,以赛带学,学以致用。无需代码,只需下载体验模板,按操作文档操作即可完成作品。参赛、邀请都有丰富奖品,还有机会拿P40 5G手机超级激励!!识别下图二维码即可报名参加。
API入门学习赛·AI人脸识别
API入门学习赛·探险寻宝之旅