# OpenApiSample

**Repository Path**: kingdee/OpenApiSample

## Basic Information

- **Project Name**: OpenApiSample
- **Description**: 金蝶云苍穹OpenAPI接入示例代码, 包括接口调用，认证使用案例
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-03-07
- **Last Updated**: 2024-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### DEMO仅供参考，实际开发中需要结合具体业务场景修改使用 ###

**运行环境:jdk1.8及以上**
## OpenapiDemo使用前必读 ##

**直接运行demo步骤如下(idea直接导入工程即可):**
1. 请先确认demo/src/main/resources/dev/application.properties配置文件是否已配置完成；
2. 摘要认证旧方式测试demo, 运行kd.bos.openapi.demo.auth.digestauth.DigestDemoByOldTest.java中的main方法, 支持苍穹4.0.011及以上；
3. 摘要认证新方式测试demo, 运行kd.bos.openapi.demo.auth.digestauth.DigestDemoTest.java中的main方法, 支持苍穹5.0.011及以上；
4. 增强型Token认证测试demo, 运行kd.bos.openapi.demo.auth.oauth2.TokenDemoTest.java中的main方法, 支持苍穹6.0.001及以上；
5. 签名认证测试demo, 运行kd.bos.openapi.demo.auth.signauth.SignAuthTest.java中的main方法, 支持苍穹5.0.011及以上；
6. webservice调用测试用例（通过axis2方式）, 运行kd.bos.openapi.demo.webservice.FindOrderCallByAxisDemo.java中的main方法, 支持苍穹5.0.011及以上；
7. webservice调用测试用例（通过http方式）, 运行kd.bos.openapi.demo.webservice.FindOrderCallByHttpDemo.java中的main方法, 支持苍穹5.0.011及以上；
8. API自定义接口调用测试demo, 运行kd.bos.openapi.demo.simple.operation.test.service.CustomOrderServiceTest.java, 支持苍穹5.0.011及以上；
9. API自定义接口调用测试demo, 运行kd.bos.openapi.demo.simple.operation.test.service.OrderServiceTest.java, 支持苍穹5.0.011及以上；

**集成至其他系统步骤如下(以摘要认证demo为例，其他系统是maven工程结构):**
1. 拷贝java目录下的kd.bos.openapi.demo.auth.digestauth.DigestDemoTest.java至其他系统源代码目录
2. 将lib目录下所有jar文件添加至其他系统lib目录，如果没有openapi-sdk.jar(此jar包有通用工具类及API接口请求或响应对象)，则将openapi-sdk编译为该jar包
3. 拷贝demo/src/main/resources/dev/application.properties配置文件至其他系统classpath根目录
4. 在其他系统项目中运行Main方法，确认集成无误
5. 使用main方法中的调用样例进行客户端系统开发

Q: 无法编译？
1. 将工程的lib依赖包加载到demo工程依赖包中；
2. 找不到maven依赖bos-open-api,bos-open-common,bos-encrypt-strict
```
mvn install:install-file -Dfile={工程目录}\lib\bos-open-api-5.0.jar -DgroupId=com.kingdee -DartifactId=bos-open-api -Dversion=5.0 -Dpackaging=jar
mvn install:install-file -Dfile={工程目录}\lib\bos-open-common-5.0.jar -DgroupId=com.kingdee -DartifactId=bos-open-common -Dversion=5.0 -Dpackaging=jar
mvn install:install-file -Dfile={工程目录}\lib\bos-encrypt-strict-5.0.jar -DgroupId=com.kingdee -DartifactId=bos-encrypt-strict -Dversion=5.0 -Dpackaging=jar
```
```
3、启用test配置目录，编译中加入-Ptest
mvn clean install -Ptest
```


## 常见问题 ##
1. 认证相关问题
https://dev.kingdee.com/open/detail/sdk/1565335175078874112
2. 增强Token认证指南
https://vip.kingdee.com/article/489812471528707840?productLineId=29&isKnowledge=2
3. 自定义服务API开发案例
https://dev.kingdee.com/open/example?id=1409286077646115840
4. 操作服务API开发案例
https://dev.kingdee.com/open/example?id=1409266743574007808