
DOC ID:KDSP_T_V4.0
第 1 页 共 33 页
K3Cloud WebAPI 接口说明书_V4.0
修改记录

DOC ID:KDSP_T_V4.0
第 2 页 共 33 页
目 录
1. 概述.....................................................................................................................................3
1.1. 目的.................................................................................................................................................3
1.2. 范围.................................................................................................................................................3
1.3. 适用对象.........................................................................................................................................3
1.4. 参考资料.........................................................................................................................................3
2. 问题与解决策略.................................................................................................................3
3. 目标和约束.........................................................................................................................4
4. WebAPI 架构......................................................................................................................4
4.1. 采用的技术.....................................................................................................................................4
4.1.1. Kingdee.BOS.WebApi.FormService.dll .........................................................................4
4.1.2. Kingdee.BOS.WebApi.ServicesStub.dll .........................................................................4
4.1.3. Kingdee.BOS.WebApi.Client.dll ....................................................................................4
4.1.4. 开发工具 .........................................................................................................................4
5. WebAPI 接口详细描述......................................................................................................5
5.1.1. 登陆验证接口 .................................................................................................................5
5.1.2. 查看表单数据接口 .........................................................................................................8
5.1.3. 保存表单数据接口 .........................................................................................................9
5.1.4. 批量保存表单数据接口 ...............................................................................................12
5.1.5. 提交表单数据接口 .......................................................................................................16
5.1.6. 审核表单数据接口 .......................................................................................................17
5.1.7. 反审核表单数据接口 ...................................................................................................18
5.1.8. 删除表单数据接口 .......................................................................................................19
5.1.9. 表单数据查询接口 .......................................................................................................21
5.1.10. 自定义 WebAPI 接口 ...................................................................................................22
5.1.11. 登录验证接口带踢人功能 ...........................................................................................25
5.1.12. 暂存表单数据接口 .......................................................................................................26
5.1.13. 分配表单数据接口 .......................................................................................................26
5.1.14 下推接口 .......................................................................................................................27
5.1.15 分组保存接口 ...............................................................................................................29
6. 附录(集成相关知识分享)...........................................................................................30

DOC ID:KDSP_T_V4.0
第 3 页 共 33 页
1. 概述
1.1. 目的
为异构系统访问 K/3Cloud 系统数据提供通用的接口。
当企业规模逐渐增大时,作为支撑业务运营的 IT 建设也变得越来越重要,不过往往企业的 IT
建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,
企业上的 IT 系统很多很全,从 ERP 到 HR、CRM、PDM、OA 等,貌似所有的业务都覆盖到了,
但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理
和战略发展。K/3Cloud 从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营
的多样化,并不是所有的业务都能在 K/3Cloud 中完成,所以我们必须在产品架构上支持更好的与外
部系统进行协同。
1.2. 范围
➢ 适用版本:V5.0 和后续版本
1.3. 适用对象
本文档适用于:
➢ 开发工程师:参考,对系统集成的实现获取全局性的设计指导。
1.4. 参考资料
2. 问题与解决策略
愿景
关注点
描述与示例

DOC ID:KDSP_T_V4.0
第 4 页 共 33 页
3. 目标和约束
目标:
➢
提供对
K/3Cloud
单据和基础信息的查看、保存、提交、审核、反审核和删除等功能;
➢
提供对
K/3Cloud
单据和基础信息的查询功能;
约束:
➢
数据操作接口仅支持以基础资料编码、单据编号或直接以表单主键去操作数据;
➢
支持对某一具体单据的数据查询,但多单关联查询需要二开接口实现。
4. WebAPI 架构
4.1. 采用的技术
K/3 Cloud WebAPI 是一种轻量级的、可维护的、可伸缩的 Web 服务。采用 HTTP+JSON,也就是
用 RESTful 的方式来开发。使用.NET Framework 4.0 为开发平台,源代码使用 C#编写。整个框架由
三个组装件组成。
4.1.1. Kingdee.BOS.WebApi.FormService.dll
此组装件包含 WebAPI 主要接口的功能实现。部署在应用层服务器。
4.1.2. Kingdee.BOS.WebApi.ServicesStub.dll
此组装件主要包含 WebAPI 接口定义,扩展接口定义以及登陆验证接口。部署在应用层服务器。
4.1.3. Kingdee.BOS.WebApi.Client.dll
此组装件为 WebAPI 的客户端组件,封装了一些在异构系统客户端访问 WebAPI 的方法,适用于 C#
程序调用。由于它应用于异构系统客户端,所以此组装件需要拷贝到异构系统客户端环境中。非 C#
程序调用可以不用拷贝。
4.1.4. 开发工具
.Net FrameWork 4.0

DOC ID:KDSP_T_V4.0
第 5 页 共 33 页
Microsoft Visual Studio 2012
5. WebAPI 接口详细描述
5.1.1. 登陆验证接口
服务地址:
http://ServerIp/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc
接口参数:
参数列表
参数含义
备注
acctID
账套 Id,从管理中心数据库查询获得
参考查询:select FDATACENTERID from
T_BAS_DATACENTER
必须
username
用户登陆名
必须
password
密码
必须
lcid
语言 id,选择哪种语言访问,参考:中文 2052,
英文 1033,繁体 3076
非必须,引用 SDK 组件辅
助类调用则必须
返回参数:
参数列表
参数含义
备注
LoginResultType
//激活
Activation = -7,
//云通行证未绑定 Cloud 账号
EntryCloudUnBind = -6,
//需要表单处理
DealWithForm = -5,
//登录警告
Wanning = -4,
//密码验证不通过(强制的)
PWInvalid_Required = -3,
//密码验证不通过(可选的)
PWInvalid_Optional = -2,
//登录失败
Failure = -1,
//用户或密码错误
PWError = 0,
//登录成功
Success = 1
管理员登陆可能出现返回-5 的情况,
这种情况在 api 验证时也可认为是
允许的,具体可以根据实际情况来定。
var result =
JObject.Parse(ret)["LoginResult
Type"].Value<int>();
if (result ==
1||result==-5)
{
return true;
}
调用参考:
1)SDK 辅助类示例(引用 Kingdee.BOS.WebAPI.Client.dll):