前言

OpenAPI是不同于webService的一种新的基于restFUL风格的接口对接方式，提供了http和Java代码两种对接方式，对接数据格式主要通过json数据来传输。支持按方案级别的权限配置；除开标准产品提供的接口以外，支持根据系统已有的entity\facade\function类型的元数据快速创建新的接口。所有接口配置操作仅支持web端操作。

支持版本 & 对应补丁

目前OpenAPI支持的版本为850及其以上版本，使用OpenAPI请首先确认补丁号，建议更新BOS_RTE对应版本最新的补丁。

850 

BOS_RTE    PT147466 首次带出

BOS_RTE    PT150114 三个页签（OpenAPI管理， 第三方对接应用管理，OpenAPI接口文档）

BOS_RTE    PT153884 同步860sp1，新增OpenAPI调用日志页签 BOS_RTE    

PT156634 OpenAPI相关显示优化 

BOS_LICENSE    PT156105 OpenAPI菜单不占用任何许可（也不占用BOS定制模块运行平台许可） 

860公有云 

BOS_RTE    PT151777 同步860sp1，携带网关等内容 

860私有云 

BOS_RTE    PT149430 

861

BOS_RTE    PT156129 OpenAPI支持方案导出，自定义实现类支持数组、泛型

对接案例一

场景：使用标准产品提供的接口对接

1. 在第三方对接应用管理菜单下新建应用

操作路径：集成管理—接口服务—第三方对接应用管理—新增

操作截图：

2. 在openAPI管理菜单下找到标准接口所在的方案

操作路径：集成管理—接口服务—openAPI管理

操作截图：

3. 给应用授权

操作路径：集成管理—接口服务—openAPI管理-权限分配

操作截图：

4. 修改配置文件，增加openAPI接口路径对应的白名单

操作路径：/kingdee86/apusic/domains/server?/config/ web.xml（每个实例下的都需要修改），找到allow_URLS配置项  增加白名单路径: /easportal/openapi/

操作截图：

5. 写Java调用文件进行调用

操作路径：新建工程    导入第三方jar包 fastjson-1.2.72.jar  log4j-1.2.15.jar  openapi-server.jar sp-openapi-server.jar

分别从对应环境中的如下目录去下载:

fastjson-1.2.72.jar  log4j-1.2.15.jar(\eas\server\lib\common\trd)

openapi-server.jar (\eas\server\lib\server\bos\)

sp-openapi-server.jar(eas\server\lib\patch\)

操作代码：

public static void invokeByHttp() throws BizException, LoginException,

InvokeNetworkException {

String ip = "123.60.11.162";

int port = 8080;

String userName = "user";

String password = "2021user";

String dcName = "kingdee_dev";

String language = "l2";

EASLoginContext loginCtx = new EASLoginContext.Builder(ip, port,

new CommonLogin.Builder(userName, password, dcName, language)

.build()).https(false).build();

OpenApiInfo info = new OpenApiInfo();

//demo1  标准预制接口  MessageCenterFacade-updateMessageStatus  更新消息的状态   oRyA0HUKTLur7vPKAiz8q0HJs5s=  0

info.setApi("MessageCenterFacade-updateMessageStatus");

info.setData("[\"oRyA0HUKTLur7vPKAiz8q0HJs5s=\",0]");

OpenApi openApi = OpenApiFactory.getService(loginCtx);

String result = openApi.invoke(info);

System.out.println("----------result:" + result);

}

对接案例二

场景：使用客户化开发增加的facade提供的接口对接

1. 在第三方对接应用管理菜单下新建应用

操作路径：集成管理—接口服务—第三方对接应用管理—新增

操作截图：

2. 在openAPI管理菜单下新建接口对接的方案

操作路径：集成管理—接口服务—openAPI管理

操作截图

新建方案

3. 在openAPI管理菜单下给应用授权

操作路径：集成管理—接口服务—openAP