系统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":""
},
]
}