获取业务类API的网关服务器
http://kd.cmcloud.cn/Kisoemapi/get_server_url
或
https://kiscloud.kingdee.com/Kisoemapi/get_server_url
Get/Post
使用client_id、client_secret、access_token认证
调用频率限制 每天调用次数限制
参数名称 | 参数类型 | 是否必填 | 参数说明 |
---|---|---|---|
eid | string | 是 | 企业号 , 金蝶KIS账务平台V14.0如何获得企业号 |
timestamp | string | 是 | 时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03,允许客户端请求时间误差为10分钟, Get方式必须urlencode |
state | string | 是 | 请求端的状态值(由大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一),最多128字节,此值将作为返回值原样返回 |
client_id | string | 是 | 应用ID,即开发者申请的应用ID(client_id),如何获取client_id? |
access_token | string | 是 | 开发者access_token, 有效期10分钟(随timestamp过期而过期),值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),auth_token是在账务平台系统管理内生成的访问口令, 如何获取访问口令? |
http://kd.cmcloud.cn/Kisoemapi/get_server_url?eid=xxx&netid=xxx×tamp=2014-03-14+11 %3A44%3A44&state=xxxxxxx&client_id=xxxxxx&access_token=xxxxxx |
参数名称 | 参数类型 | 参数说明 |
---|---|---|
code | int | 返回码:200 正常,大于200 异常 |
msg | string | 如果Result不为200,会有相应的错误信息提示,UTF-8编码 比如: 403 非法请求 300 超过请求频率限制 301 超过每天的请求次数限制 200 获取成功 201 获取失败,失败原因 |
state | string | 请求接口提交的state值,帮助开发者防范CSRF攻击 |
data | array | 如果代码为200 返回data |
参数名称 | 参数类型 | 参数说明 |
---|---|---|
server_url | string | 账务平台业务类API服务器URL 形如:https://kisgz.kingdee.com 或 120.132.144.218 或 http://120.132.144.218 三种形式,且仅 kisgz.kingdee.com 这个域名使用https |
netid | string | 网络ID,调用路由接口必须参数 |
prod_name | string | 产品实例名称,每个网络ID必对应一个产品实例名称,若企业(同一个企业号)有多个产品实例运行时,需要弹出界面显示产品实例名称供客户选择,若企业仅运行一个产品实例,不需弹出界面,默认选择 |
logintime | datetime | 企业最近登录产品实例时间,若多条产品实例,按照这个时间倒序排列 |
{
"code":200, "msg":"success", "state":"xxxxxxxxx", "data":[ { "server_url":"http://192.168.10.11", "netid":"xxxxx", "prod_name":"", "logintime":"" }, ]
}