金蝶云·星空 SDK介绍

更新时间：2020年11月5日

欢迎使用金蝶云星空OpenAPI-SDK，金蝶云星空开放平台提供了.Net、Java和Python三个语言版本的SDK。

所有语言版本的SDK都要基于7.3.1310.2版本的补丁，并且通过新版第三方系统登录授权才能使用。

下载地址

资料包下载：OpenAPI 资料包

依赖环境

若要使用新版OpenAPI SDK,您的金蝶云星空产品必须升级到PT136657【7.3.1310.2】及以上版本，如下图所示。

登录配置文件说明

步骤 1

以管理员账号Administrator登录金蝶云星空产品，进入系统管理菜单下的第三方系统登录授权功能。

步骤 2

点击新增按钮，新增一个第三方系统登录授权信息。

第三方系统登录授权信息，示例如下图所示。

登录授权操作完毕后，点击生成测试链接按钮，验证是否授权成功，示例如下图所示。

.NET

更新时间：2020年11月5日

欢迎使用金蝶云星空OpenAPI-SDK。本文以 .Net SDK 为例，介绍如何使用、调试并接入金蝶云星空API。

下载地址

资料包下载：OpenAPI 资料包

资料包中包含测试工程、需要引用的组件、新手入门操作指南

依赖环境

若要使用新版OpenAPI SDK,您的金蝶云星空产品必须升级到PT136657【7.3.1310.2】及以上版本，如下图所示。

引用关键文件

开发者需引用资料包中SDK 文件夹内名为Kingdee.BOS.WebApi.Client.dll的文件。如下图所示。

登录配置文件说明

步骤 1

以管理员账号Administrator登录金蝶云星空产品，进入系统管理菜单下的第三方系统登录授权功能。

步骤 2

点击新增按钮，新增一个第三方系统登录授权信息。

第三方系统登录授权信息，示例如下图所示。

登录授权操作完毕后，点击生成测试链接按钮，验证是否授权成功，示例如下图所示。

步骤 3

将步骤2中新生成的应用ID、应用名称、应用密钥和集成用户名称这四个信息，加入第三方产品项目的配置文件中，示例如下。

<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <!-- 当前使用的 账套ID (即数据中心ID) --> <add key="X-KDApi-AcctID" value="5*************"/> <!-- 第三方系统登录授权的 集成用户名称 --> <add key="X-KDApi-UserName" value="*************"/> <!-- 第三方系统登录授权的 应用ID --> <add key="X-KDApi-AppID" value="207************************************************"/> <!-- 第三方系统登录授权的 应用密钥 --> <add key="X-KDApi-AppSec" value="**************************e754a9"/> <!-- 账套语系，默认2052 --> <add key="X-KDApi-LCID" value="2052"/> <!-- 组织编码，启用多组织时配置对应的组织编码才有效 --> <!--<add key="X-KDApi-OrgNum" value="*****"/>--> <!—私有云客户，可以将url 指向产品部署地址 --> <add key="X-KDApi-ServerUrl" value="http://*************/k3cloud/"/> </appSettings> </configuration>

情况1：如果基于IIS站点运行项目工程，则将上面的第三方系统登录授权信息加入WebSite下的WebConfig配置文件中，如下图所示。

情况2：如果是基于本地桌面应用程序运行的项目工程，则新增App.config配置文件，加入上面的第三方系统登录授权信息，如下图所示。

Java

更新时间：2020年11月5日

欢迎使用金蝶云星空OpenAPI-SDK，本文以 java SDK 为例，介绍如何使用、调试并接入金蝶云星空API。

下载地址

资料包下载：OpenAPI 资料包

资料包中包含测试工程、需要引用的组件、新手入门操作指南

依赖环境

若要使用新版OpenAPI SDK,您的金蝶云星空产品必须升级到PT136657【7.3.1310.2】及以上版本，如下图所示。

引用关键文件

开发者需引用资料包中SDK 文件夹内名为k3cloud-webapi-sdk.7.0.jar的文件。如下图所示。

登录配置文件说明

步骤 1

以管理员账号Administrator登录金蝶云星空产品，进入系统管理菜单下的第三方系统登录授权功能。

步骤 2

点击新增按钮，新增一个第三方系统登录授权信息。

第三方系统登录授权信息，示例如下图所示。

登录授权操作完毕后，点击生成测试链接按钮，验证是否授权成功，示例如下图所示。

步骤 3

将步骤2中新生成的应用ID、应用名称、应用密钥和集成用户名称这四个信息，加入第三方产品项目的配置文件中，示例如下。

# 第三方系统登录授权的账套ID（即数据中心ID） X-KDApi-AcctID = ************************ # 第三方系统登录授权的用户 X-KDApi-UserName = ************************ # 第三方系统登录授权的应用ID X-KDApi-AppID = ************************************************ # 第三方系统登录授权的应用密钥 X-KDApi-AppSec = ******************************************** # 服务Url地址 X-KDApi-ServerUrl =************************ # 账套语系，默认2052 # X-KDApi-LCID = 2052 # 组织编码，启用多组织时配置对应的组织编码才有效 # X-KDApi-OrgNum = *******

情况1：如果是基于本地应用程序运行的项目工程，则新增项目配置文件 kdwebapi.properties，如下图所示。

Python

更新时间：2020年11月5日

欢迎使用金蝶云星空OpenAPI-SDK。本文以 Python SDK 为例，介绍如何使用、调试并接入金蝶云星空API。

下载地址

资料包下载：OpenAPI 资料包

资料包中包含测试工程、需要引用的组件、新手入门操作指南

依赖环境

若要使用新版OpenAPI SDK,您的金蝶云星空产品必须升级到PT136657【7.3.1310.2】及以上版本，如下图所示。

引用关键文件

开发者需安装k3cloud_webapi_sdk文件。如下图所示。

使用pip安装指令格式：pip install {后缀为.whl的SDK包文件的本地完整目录} pip install F:\Python\k3cloud_webapi_sdk-1.0.0-py3-none-any.whl

登录配置文件说明

步骤 1

以管理员账号Administrator登录金蝶云星空产品，进入系统管理菜单下的第三方系统登录授权功能。

步骤 2

点击新增按钮，新增一个第三方系统登录授权信息。

第三方系统登录授权信息，示例如下图所示。

登录授权操作完毕后，点击生成测试链接按钮，验证是否授权成功，示例如下图所示。

步骤 3

将步骤2中新生成的应用ID、应用名称、应用密钥和集成用户名称这四个信息，加入第三方产品项目的配置文件中，示例如下。

[config] # 第三方系统登录授权的账套ID(即数据中心ID) X-KDApi-AcctID = ************************ # 第三方系统登录授权的用户 X-KDApi-UserName = *********** # 第三方系统登录授权的应用ID X-KDApi-AppID = **************** # 第三方系统登录授权的应用密钥 X-KDApi-AppSec = ************************ # 账套语系，默认2052 # X-KDApi-LCID = 2052 # 组织编码，启用多组织时配置对应的组织编码才有效 # X-KDApi-OrgNum = ******** # 若使用代理，配置此参数 # X-KDApi-Proxy = ************************

情况1：如果是基于本地应用程序运行的项目工程，则新增项目配置文件conf.ini节点为config：（配置参数名称不区分大小写）如下所示。