自定义服务插件

标签：

接口，自定义服务，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：按照约定传指定参数调用接口