将 30 行由:
||access_token||string ||是||开发者access_token,%red%有效期10分钟(随timestamp过期而过期,%%值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),%red%auth_token由企业管理员在系统管理内生成的访问口令,[[Site.BusinessIssue3|如何获取访问口令?]]
更新为以下内容:
||access_token||string ||是||开发者access_token,%red%有效期10分钟(随timestamp过期而过期,%%值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),%red%auth_token由企业管理员在系统管理内生成的访问口令,%%[[Site.BusinessIssue3|如何获取访问口令?]]
将 30 行由:
||access_token||string ||是||开发者access_token,%red%有效期10分钟(随timestamp过期而过期,%%值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),%red%auth_token由企业管理员在系统管理内生成的访问口令
更新为以下内容:
||access_token||string ||是||开发者access_token,%red%有效期10分钟(随timestamp过期而过期,%%值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),%red%auth_token由企业管理员在系统管理内生成的访问口令,[[Site.BusinessIssue3|如何获取访问口令?]]
改为:
!业务类API中控路由接口(/Webapi/router)
更新为以下内容:
!业务类API/Kisopenapi/router(API中控路由接口)
将 4 行由:
正式:http://'[server_url]'/Webapi/router
更新为以下内容:
正式:https: //[server_url]/Kisopenapi/router
改为:
测试:http://kd.cmcloud.cn:8080/Webapi/router
注意:[server_url]是从接口 /Kisoemapi/get_server_url 获取的ServerUrl参数值
更新为以下内容:
测试:http://kd.cmcloud.cn:8080/Kisopenapi/router
注意:[server_url]是由系统类接口 get_server_url 动态获取
改为:
更新为以下内容:
使用client_id、client_secret、access_token认证
改为:
调用API ,必须传入系统参数和应用参数。系统参数详细介绍如下;应用参数由于不同 API 各自不同,应用参数请参考具体的API 文档。
更新为以下内容:
调用API ,必须传入系统参数和应用参数。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。
改为:
||EID ||string ||是||企业号
||NetID||string ||是||网络ID ,网络ID,从get_server_url获取的NetID值
||ClientID||string ||是||开发者ID,即申请成为开发者分配的client_id
||Method||string ||是||API接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.uesapi.uesaccountmanger.getaccountlist
||Timestamp||string ||是||时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03。KD API服务端允许客户端请求时间误差为5分钟
||Sign||string ||是||签名,值为md5(Timetamp + EID + ClientID + Token + Method + State ),其中加号“+”为字符串连接符,Token是KIS账务平台系统管理内由KIS账务平台管理员生成,MD5的值为32位大写
||State||string ||是||请求端的状态值(由长度大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一),重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节
||Ver||string ||是||API协议版本,目前固定值为:2.0
||IsEncrypt||string ||否||CustData数据是否加密,Y为加密,N为不加密,默认为N
||FromTag||string ||否||来源标识
!!'''应用参数数据包'''
更新为以下内容:
||eid||string ||是||企业号
||netid||string ||是||网络ID ,从get_server_url 接口获取
||client_id||string ||是||开发商请求接口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由企业管理员在系统管理内生成的访问口令
||method||string ||是||API接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.App001804.acctplatform.AcctController.DealAcctPlatForm
||timestamp||string ||是||时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03,允许客户端请求时间误差为10分钟,需要urlencode,Get方式必须urlencode
||ver||string ||是||API协议版本,目前版本为 2.0,如:2.0
||state||string ||是||请求端的状态值%red%(由大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一)%%最多128字节,此值将作为返回值原样返回
||fromtag||string ||否||来源标识
||custdata||string ||是||应用参数数据包,应用API 业务json数据包,业务数据参数请参考API说明, 需urlencode处理
!!'''应用参数数据包custdata参数格式(业务参数注意大小写)'''
删除了 38-42 行中的以下内容
||CustData||string ||是||应用API 业务json数据包,业务数据参数请参考API说明
!!'''CustData参数格式'''
|| class=table-of-content
||!参数名称 ||!参数类型||!是否必填||!参数说明||
改为:
||Data||string ||是||业务端Json数据包,业务数据参数请参考具体业务API说明(即Method参数对应的API名称)
更新为以下内容:
||每页多少条记录||string ||是||业务端Json数据包,业务数据参数请参考具体业务API说明(即Method参数对应的API名称)
改为:
||!参数名称 ||!参数类型||!是否必填||!参数说明||
||Result||string ||是||返回结果代码
||Msg||string ||否||错误提示文本
||DataJson||string ||否||返回业务处理结果数据,详情参考具体API说明
更新为以下内容:
||!参数名称 ||!参数类型||!参数说明||
||Result||string ||返回码:200 正常,大于200 异常
||ErrMsg||string ||错误提示文本,如果Result大于200,会有相应的错误信息提,UTF-8编码,比如:\\
403 非法路由请求,access_token校验失败,client_secret或auth_token错误\\
303 超过数据流量\\
200 接口路由成功\\
201 接口路由失败,失败原因\\
若Result 小于 200,则为业务API的返回值
||State||string ||请求接口提交的state值,帮助开发者防范CSRF攻击
||DataJson||string ||业务端API的返回json数据
改为:
“Result”:"",
“Msg”:"",
“DataJson”:{ …}
更新为以下内容:
“Result”:200,
“ErrMsg”:”success”,
“State”:”xxxxxx”,
“DataJson”:{
“Result”:”业务API返回代码”,
“ErrMsg”:”业务API返回值说明”,
“Data”:””,
……
}
删除了 73-75 行中的以下内容
!!如下:
|| class=pre
||http://[server_url]/Webapi/Router?EID=16888&Sign=72CB4D809B375A54502C09360D879C64&Timestamp=2014-03-14+13%3A52%3A03&Ver=1.0&Method=kis.syncuser.get&State= de6367bt8515821a&CustData= dfd7sd4eCB4D80re9B3sdfds75A23r54502dteC093tsdfsd60D87r9C64tsh4t||