如何使用SDK?

如何使用SDK

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

SDK支持的API列表

开发者需要清晰明确自己的金蝶云星空版本，然后基于SDK进行开发。如下图所示。

依赖环境

前置信息

首选需要获取第三方授权信息，具体操作查看《如何获取第三方登录授权？》

SDK下载

前往OpenAPI网站的SDK中心下载最新版本的SDK>> 前往下载

NET版本SDK使用指南

引用关键文件

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

第三方授权登录配置文件说明

将第三方系统登录授权信息，严格按照格式，加入第三方产品项目的配置文件中，示例如下。

<?xml version="1.0" encoding="utf-8" ?>

<configuration>

<appSettings>

<!-- 当前使用的 账套ID(即数据中心id) -->

<!-- 第三方系统登录授权的账套ID（即open.kingdee.com网站的第三方系统登录授权中的数据中心标识）-->

<!-- 在第三方系统登录授权页面点击“生成测试链接”按钮后即可查看   -->

<add key="X-KDApi-AcctID" value="5*************"/>

<!-- 第三方系统登录授权的 集成用户名称  -->

<!-- 补丁版本为PT-146894 [7.7.0.202111]及后续的版本，则为指定用户登录列表中任一用户  -->

<!-- 若第三方系统登录授权已勾选“允许全部用户登录”，则无以上限制  -->

<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地址(私有云和公有云都须配置金蝶云星空产品地址，K3Cloud/结尾)-->

<add key="X-KDApi-ServerUrl" value="http://*************/k3cloud/"/> 

</appSettings>

</configuration>

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

（PS：该配置文件和对应的项目文件都应为utf-8编码，当用户名为中文名时尤其需要注意。）

Java版本SDK使用指南

引用关键文件

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

第三方授权登录配置文件说明

将第三方系统登录授权信息，严格按照格式，加入第三方产品项目的配置文件中，示例如下。

# 当前使用的 账套ID(即数据中心id)

# 第三方系统登录授权的账套ID（即open.kingdee.com网站的第三方系统登录授权中的数据中心标识）

# 在第三方系统登录授权页面点击“生成测试链接”按钮后即可查看

X-KDApi-AcctID = ************************

# 第三方系统登录授权的 集成用户名称

# 补丁版本为PT-14