将 58 行由:
%red%形如:%newwin%[[https://kisgz.kingdee.com]] 或 120.132.144.218 或 http ://120.132.144.218 三种形式%%
更新为以下内容:
%red%形如:%newwin%[[https://kisgz.kingdee.com]] 或 120.132.144.218 或 %newwin%[[http://120.132.144.218]] 三种形式%%
将 72 行由:
"server_url":"http ://192.168.10.11",
更新为以下内容:
"server_url":"%newwin%[[http://192.168.10.11]]",
改为:
||Result||int||返回码:200 正常,大于200 异常
||ErrMsg||string||如果Result不为200,会有相应的错误信息提示,UTF-8编码 比如:\\
更新为以下内容:
||code||int||返回码:200 正常,大于200 异常
||msg||string||如果Result不为200,会有相应的错误信息提示,UTF-8编码 比如:\\
改为:
||State||string||请求接口提交的state值,帮助开发者防范CSRF攻击
||Data||Data||如果Result为200 返回data
更新为以下内容:
||state||string||请求接口提交的state值,帮助开发者防范CSRF攻击
||sata||Data||如果代码为200 返回data
改为:
"Result":200,
"ErrMsg":"success",
"State":"xxxxxxxxx",
"Data":[
更新为以下内容:
"code":200,
"msg":"success",
"state":"xxxxxxxxx",
"data":[
将 54 行由:
%red%形如:https ://kisgz.kingdee.com 或 120.132.144.218 或 http://120.132.144.218 三种形式%%
更新为以下内容:
%red%形如:https ://kisgz.kingdee.com 或 120.132.144.218 或 http ://120.132.144.218 三种形式%%
将 68 行由:
"server_url":"http://192.168.10.11",
更新为以下内容:
"server_url":"http ://192.168.10.11",
改为:
由开发者申请的 client_id 、client_secret 认证
更新为以下内容:
使用client_id、client_secret、access_token认证
改为:
||EID ||string ||是||企业号
||Timestamp||string ||是||时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03,KD API服务端允许客户端请求时间误差为3分钟,需要urlencode,Get方式需要urlencode
||ClientID||string ||是||开发者ID,即申请成为开发者分配的client_id
||Sign||string ||是||签名串,值为md5(Timestamp + EID + ClientID + ClientSecret + State ),其中加号“+”为字符串连接符,ClientSecret就是申请成为开发者分配的client_secret
||State||string ||是||请求端的状态值(由长度大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一),重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节
!!'''格式:'''
更新为以下内容:
||eid||string ||是||企业号
||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,即开发者申请的client_id
||access_token||string ||是||开发者access_token,%red% 有效期10分钟(随timestamp过期而过期),%%值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),%red%auth_token由企业管理员在系统管理内生成的访问口令
!!'''Get方法格式:'''
改为:
||http://[server_url]/Kisoemapi/get_server_url?\\
EID=xxx&Sign=xxxx&Timestamp=2014-03-14+11%3A44%3A44&State=xxxxxxx&ClientID =xxxx||
更新为以下内容:
||http://[server_url]/Kisoemapi/get_server_url?eid=xxx&netid=xxx×tamp=2014-03-14+11\\
%3A44%3A44&state=xxxxxxx&client_id=xxxxxx&access_token=xxxxxx||
改为:
||Msg||string||如果Result不为200,会有相应的错误信息提示,UTF-8编码 ,比如:403 非法请求,200 获取成功,201 获取失败,失败原因
||Data||array||如果Result为200 返回Data,若Data有多个值,显示产品名称,第三方系统需要弹出界面供用户选择其中一个产品;若Data仅有一个值,第三方系统不需弹出选择界面,系统自动选择,然后供业务类API路由接口 /Webapi/router使用
更新为以下内容:
||ErrMsg||string||如果Result不为200,会有相应的错误信息提示,UTF-8编码 比如:\\
403 非法请求 \\
300 超过请求频率限制\\
301 超过每天的请求次数限制\\
200 获取成功\\
201 获取失败,失败原因
||State||string||请求接口提交的state值,帮助开发者防范CSRF攻击
||Data||Data||如果Result为200 返回data
改为:
||NetID||string||网络ID,若不存在网络ID,会直接返回企业号
||ProductName||string||产品名称(仅用于多个产品实例时,供客户选择需要)
||ServerUrl||string||业务类API的server_url
||AppSecret||string||业务类API的应用数据(CustData)加密密钥
更新为以下内容:
||server_url||string||账务平台业务类API服务器
||netid||string||网络ID,调用路由接口必须参数
||prod_name||string||产品实例名称,每个网络ID必对应一个产品实例名称,若企业(同一个企业号)有多个产品实例运行时,需要弹出界面显示产品实例名称供客户选择,若企业仅运行一个产品实例,不需弹出界面,默认选择
||logintime||datetime||企业最近登录产品实例时间,若多条产品实例,按照这个时间倒序排列
改为:
更新为以下内容:
"ErrMsg":"success",
"State":"xxxxxxxxx",
改为:
{"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120","AppSecret":""},
{"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120", "AppSecret":""},
......
更新为以下内容:
{
"server_url":"xxx",
"netid":"xxxxx",
"prod_name":"",
"logintime":""
},
在 1-64 行中增加以下内容:
!获取业务类API的server_url
!!/Kisoemapi/get_server_url
!!请求地址url
正式:http://kd.cmcloud.cn/Kisoemapi/get_server_url
测试:http://kd.cmcloud.cn:8080/Kisoemapi/get_server_url
!!请求方式
Get/Post
!!认证方式
由开发者申请的 client_id 、client_secret 认证
!!调用限制
调用频率限制
每天调用次数限制
!!请求参数
|| class=table-of-content
||!参数名称 ||!参数类型||!是否必填||!参数说明||
||EID ||string ||是||企业号
||Timestamp||string ||是||时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03,KD API服务端允许客户端请求时间误差为3分钟,需要urlencode,Get方式需要urlencode
||ClientID||string ||是||开发者ID,即申请成为开发者分配的client_id
||Sign||string ||是||签名串,值为md5(Timestamp + EID + ClientID + ClientSecret + State ),其中加号“+”为字符串连接符,ClientSecret就是申请成为开发者分配的client_secret
||State||string ||是||请求端的状态值(由长度大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一),重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节
!!格式:
|| class=pre
||http://[server_url]/Kisoemapi/get_server_url?\\
EID=xxx&Sign=xxxx&Timestamp=2014-03-14+11%3A44%3A44&State=xxxxxxx&ClientID =xxxx||
!!返回结果
|| class=table-of-content
||!参数名称 ||!参数类型||!参数说明||
||Result||int||返回码:200 正常,大于200 异常
||Msg||string||如果Result不为200,会有相应的错误信息提示,UTF-8编码 ,比如:403 非法请求,200 获取成功,201 获取失败,失败原因
||Data||array||如果Result为200 返回Data,若Data有多个值,显示产品名称,第三方系统需要弹出界面供用户选择其中一个产品;若Data仅有一个值,第三方系统不需弹出选择界面,系统自动选择,然后供业务类API路由接口 /Webapi/router使用
!!Data参数格式
|| class=table-of-content
||!参数名称 ||!参数类型||!参数说明||
||NetID||string||网络ID,若不存在网络ID,会直接返回企业号
||ProductName||string||产品名称(仅用于多个产品实例时,供客户选择需要)
||ServerUrl||string||业务类API的server_url
||AppSecret||string||业务类API的应用数据(CustData)加密密钥
!!返回格式:
{
"Result":200,
"Msg":"success",
"Data":[
{"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120","AppSecret":""},
{"NetID":"","ProductName":"" ,"ServerUrl":"192.168.1.120", "AppSecret":""},
......
]
}