建设开发者生态: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 入门学习赛·探险寻宝之旅
报名地址
版权声明: 本文为 InfoQ 作者【华为云开发者社区】的原创文章。
原文链接:【http://xie.infoq.cn/article/088a2a474d702fe46c6f30051】。文章转载请联系作者。
评论