OpenAPI2.0—轻松构建WebService服务
你是否还在使用传统复杂的CXF框架开发WebService接口来对接遗留应用系统?
你是否还在为如何快速轻松地一键生成WebService接口而烦恼呢?
现在,是时候跟所有的烦恼说Bye Bye了~OpenAPI2.0支持将Rest API一键发布为WebService协议接口,支持Soap1.1、Soap1.2协议标准。
下面,就跟小编一起来探索OpenAPI2.0新增的功能吧~
1 适用版本
该功能适用版本为金蝶云·苍穹V4.0.020及以上。
2 功能速览
OpenAPI2.0支持2种方式将普通的Rest API接口发布成WebService协议接口,如下:
1) 零代码配置方式:将操作对象发布为操作服务API,并添加WebService协议命名空间、输入/输出参数名即可。
2) Java或脚本插件方式:使用Java代码或脚本插件方式开发复杂的自定义逻辑并发布成WebService服务。
3 功能详情
3.1 配置发布的WebService
1)新建操作API
菜单路径:【API管理】→【新增】 →【操作API(零代码配置)】/【自定义API-Java】/【自定义API-脚本插件】。随后,维护API编码,并配置出入参。
2)维护WebService信息
配置WebService协议命名空间、输入/输出参数名。
配置WebService示例
3.2 测试API
OpenAPI2.0内置了测试功能,可快速调试、验证API逻辑是否正确。在API测试页面,可选择JSON/XML/Soap1.1/Soap1.2协议。
协议选择示例
3.3 使用SoapUI测试WebService
OpenAPI内置的API测试工具无需额外获取token,并且可自动构造请求入参,调试接口方便快捷。如果需要给外部客户调试苍穹WebService接口,可以使用第三方SoapUI工具,具体分为三步:
1) 查看WSDL描述
可点击API详情页的“测试”按钮获取完整API地址:http://苍穹服务URL/kapi/API请求地址。
如:http://localhost:8080/ierp/kapi/v2/ai/openapi/test2/getCustomTest
API完整地址
WSDL地址为API地址后添加字符串“?wsdl”。在浏览器中测试或在SoapUI添加WSDL时要先获取token,并在URL后面添加:“&access_token=你的token”。
如:http://localhost:8080/ierp/kapi/v2/ai/openapi/test2/getCustomTest?wsdl&access_token=1134768014277739520_3gBxxxxx
2) 在SoapUI中添加WebService接口
将上一步带有accesstoken的URL添加为WSDL。
将accesstoken的URL添加为WSDL
3) 在SoapUI中测试WebService
设置相应的请求参数,注意参数值的类型及值的合法性,并添加请求Headers:accesstoken。点击“测试”按钮,测试返回的Soap报文是否正确。
测试返回值示例
4 亮点价值
亮点一:零代码配置快速生成API。可将苍穹任何操作对象快速发布成API,无需编写一行代码,方便快捷。
亮点二:一键发布成WebService协议接口。可将任何POST类型的OpenAPI接口,配置WebService参数信息后,发布成符合Soap1.1/Soap1.2协议标准的WebService接口,节省了大量的接口开发时间。
亮点三:一键测试,方便快捷。内置的API测试工具,可快速测试JSON/XML/Soap1.1/Soap1.2接口,无需借助第三方调试工具。
亮点四:功能强大。对于复杂的业务逻辑,可使用Java插件或脚本插件开发OpenAPI接口,并发布成WebService协议。
5 划重点
本次金蝶云·苍穹OpenAPI2.0发布新特性主要体现在:
1) 开放平台可将任何POST协议API接口发布成WebService协议。
2)开放平台支持API、WebService的在线测试,自动构建请求入参。
#往期推荐#
更多精彩内容,“码”上了解!↓
OpenAPI2.0—轻松构建WebService服务
本文2024-09-23 00:27:24发表“云苍穹知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-cangqiong-139575.html