/kss_api/api.php,开发文档 | Site / SystemApi

系统API

接口说明

获取业务类API的网关服务器

请求地址url

或

请求方式

Get/Post

认证方式

使用client_id、client_secret、access_token认证

调用限制

调用频率限制

每天调用次数限制

请求参数：参数名称需区分大小写

参数名称参数类型是否必填参数说明

timestampstring是时间戳，格式为yyyy-mm-dd HH:mm:ss，例如：2014-03-14 16:52:03，允许客户端请求时间误差为10分钟， Get方式必须urlencode

statestring是请求端的状态值(由大于等于16位大小写字母和数字组成，要求每次的随机数不能重复，必须唯一)，最多128字节，此值将作为返回值原样返回

client_idstring是应用ID，即开发者申请的应用ID(client_id)，如何获取client_id?

access_tokenstring是开发者access_token，有效期10分钟(随timestamp过期而过期)，值为md5( timestamp + client_id + client_secret + auth_token + state )，其中加号“+”为字符串连接符，client_id 、client_secret是开发者在开放平台后台申请(务必保密，切勿泄露，一旦泄露请及时更新)，auth_token是在账务平台系统管理内生成的访问口令， 如何获取访问口令？

Get方法格式：

返回结果

参数名称参数类型参数说明

codeint返回码：200 正常，大于200 异常

msgstring如果Result不为200，会有相应的错误信息提示，UTF-8编码 比如：

403 非法请求

300 超过请求频率限制

301 超过每天的请求次数限制

200 获取成功

201 获取失败，失败原因

statestring请求接口提交的state值，帮助开发者防范CSRF攻击

dataarray如果代码为200 返回data

Data参数格式

参数名称参数类型参数说明

server_urlstring账务平台业务类API服务器URL

形如：https://kisgz.kingdee.com 或 120.132.144.218 或 http://120.132.144.218 三种形式，且仅 kisgz.kingdee.com 这个域名使用https

netidstring网络ID，调用路由接口必须参数

prod_namestring产品实例名称，每个网络ID必对应一个产品实例名称，若企业(同一个企业号)有多个产品实例运行时，需要弹出界面显示产品实例名称供客户选择，若企业仅运行一个产品实例，不需弹出界面，默认选择

logintimedatetime企业最近登录产品实例时间，若多条产品实例，按照这个时间倒序排列

返回格式：

{"code":200,

"msg":"success",

"state":"xxxxxxxxx",

"data":[

{

"server_url":"http://192.168.10.11",

"netid":"xxxxx",

"prod_name":"",

"logintime":""

}，

]

}