华为云计算 云知识 华为云CodeArts API实用体验入门篇:API开发的必备神器
华为云CodeArts API实用体验入门篇:API开发的必备神器

API开发的必备神器:华为云CodeArts API实用体验入门篇

今天我想给大家推荐一款API全生命周期研发与管理工具:华为云CodeArts API

作为互联网软件的开发者,在软件研发的过程中,API的开发、调试、测试是必不可少的。之前我使用的是Postman这类工具来辅助开发, Postman在接口调试方面确实有一定的优势。然而,随着项目复杂度的提升和团队协作需求的演变,我们开始寻求在API设计的标准化、接口编排测试、以及Mock服务的高效集成等方面更加全面且高效的 解决方案

直到同事向我推荐了华为云CodeArts API,我们亲身体验了华为产品,解决上述需求方面的出色表现让我欣喜,所以我迫不及待地想将其分享给大家,希望能帮助更多的开发者解决开发中遇到的问题。

在试用CodeArts API以后,我遇到的第一个问题就是如何把Postman上的数据 迁移 到新工具上,当然可以将Collection一个一个的导出,并导入到新工具上,但是由于我之前的接口太多了,显然一个个操作是一件很困难的事情。

CodeArts API特别强化了对Postman用户迁移数据的支持,现在可直接导入Postman全量的Collections文件与Environments环境变量,这意味着数据迁移将会变得非常便捷。

首先从Postman的Settings -> Data页面,将Collections和Environments 数据集 导出,此时可以得到一个ZIP的压缩包,其中包含了多个Collection和Environment文件。

我们可以选择将此压缩文件导入到CodeArts API的API设计或快捷调试。

    选择要导入的ZIP文件压缩包,并可以选择接口和环境变量。

导入成功后发现,原来在Postman上同一个接口的快捷调试将会被合并,变成一个API下面的调试用例,API设计完全与我的项目一致,以后再需要调试,就可以直接使用API设计的调试能力了。

并且在Postman中,为API调试写的脚本也都同步迁移过来了,而且可以继续运行,CodeArts API的接口调试脚本完美兼容了Postman。

 

  • 可视化API设计与Swagger原生编辑

由于我之前使用的是Postman的离线版本,主要将Postman作为接口的调试工具,没有使用过Postman做接口设计。这次在试用CodeArts API过程中,发现它在API设计上的精彩表现,所以我也想尝试下API设计。

CodeArts API与传统的API设计工具有所区别,我们项目组都是将API编写为Swagger的Yaml格式文件,并提交到代码仓中,然后通过maven插件去生成接口与变量的java代码。但是对于项目组的新员工并不是很友好,并且在排查接口文件内容的时候,也经常需要花费很多精力。

CodeArts API可以支持可视化的API设计,这对于菜鸟是非常友好的。

与此同时,如果是像我一样有经验的开发者,也可以使用Swagger原生编辑器去设计API,并且CodeArts API提供了设计规范检查功能,可以在Swagger编辑器中查看是否编写错误。

并且CodeArts API支持将接口文档以yaml的格式导出,直接将其复制到代码中提交即可,这极大的提升了设计效率,所以以后我也会把CodeArts API作为我的软件设计工具首选。

目前我也是刚刚开始使用华为云的CodeArts API工具,除了以上分享的功能外,CodeArts API还提供了API Mock和API测试等能力,深度使用以后,我会持续跟大家分享我的实用体验

 

 

上一篇:华为好望商城丨买算法就像逛淘宝,一键部署到摄像机 下一篇:认识华为云市场严选商城

华为云开发者中心为开发者提供所有云服务的API及API手册、各产品的SDK、可服务的节点区域和各服务的终端节点EndPoint和在使用华为云产品时需要用到的CLI工具、业务工具等的下载及使用说明。