本文介绍了如何在使用苍穹平台时,通过自定义服务实现接口以满足特定业务需求。方案包括创建第三方应用、新增自定义服务、编写Java插件并重写方法以实现服务逻辑,最后注册插件并重启服务。调用自定义服务前需获取access_token,之后携带该token及参数调用服务接口。
标签:
接口,自定义服务,API
需求背景:
苍穹提供的操作服务依赖于业务对象不能满足特定场景的业务需求,且参数无法自定义传输。而自定义服务可以将任何功能开发出来,这类服务不依附任何业务对象,出入参数可以完全自定义。
实现方案:
1:创建第三方应用,记住系统编码和系统密码,后面接口要用到
2:新增自定义服务,编辑api名称,api编码,请求方式,所属应用,无需关联业务实体
3:编写java插件
实现IBillWebApiPlugin接口,重写doCustomService方法
params是接口入参,通过key-value取值。
返回值是ApiResult类型,可以直接返回异常,错误信息提示和错误编码,亦可以返回字符串或json格式数据包,见图-2.
图1
图2
4:将插件注册到自定义服务中
重启苍穹服务,自定义服务即制作完成
实现效果:
一:调用自定义服务接口前应先获取access_token。
步骤如下
1:执行下面接口
苍穹服务地址/api/getAppToken.do
appId:前面注册第三方应用的系统编码
appSecuret:前面注册第三方应用的系统密码
tenantid:你的苍穹租户id,登录mc在租户列表可以查看
accountId:数据中心编码,登录mc,在租户中可以查看数据中心编码
2:执行第二个接口
苍穹服务地址/api/login.do
user:需要调用自定义服务的用户手机号
apptoken:上一个接口返回的参数app_token的值
tenanted:租户编码同上
accountId:数据中心编码同上
最后拿到access_token
二:调用自定义服务接口
1:请求头传入access_token
2:按照约定传指定参数调用接口
自定义服务插件.docx(665.42KB)
推荐阅读
您的鼓励与嘉奖将成为创作者们前进的动力,如果觉得本文还不错,可以给予作者创作打赏哦!
请选择打赏金币数 *