系统API

接口说明

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

请求地址url

http://kd.cmcloud.cn/Kisoemapi/get_server_url

https://kiscloud.kingdee.com/Kisoemapi/get_server_url

请求方式

Get/Post

认证方式

使用client_id、client_secret、access_token认证

调用限制

调用频率限制 每天调用次数限制

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

参数名称参数类型是否必填参数说明
eidstring企业号 , 金蝶KIS账务平台V14.0如何获得企业号
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方法格式:

http://kd.cmcloud.cn/Kisoemapi/get_server_url?eid=xxx&netid=xxx&timestamp=2014-03-14+11
%3A44%3A44&state=xxxxxxx&client_id=xxxxxx&access_token=xxxxxx

返回结果

参数名称参数类型参数说明
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":""
                },

            ]

}