Site.GatewayApi的历史版本

显示细微更改 - 以Markup源码显示

2016年-06月-21日219.133.170.76 -
将 4 行由:

业务类API中控路由入口

更新为以下内容:

业务类API路由入口

2016年-06月-21日219.133.170.76 -
将 36 行由:
custdatastring应用参数数据包,应用API 业务json数据包,业务数据参数请参考API说明, 需urlencode处理
更新为以下内容:
custdatastring应用参数数据包,应用API 业务json数据包,业务数据参数请参考API说明, 需urlencode处理
2016年-06月-21日219.133.170.76 -
将 21 行由:

调用API ,必须传入系统参数和应用参数(参数需区分大小写)。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。

更新为以下内容:

调用API ,必须传入系统参数和应用参数(参数名称需区分大小写)。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。

2016年-06月-21日219.133.170.76 -
将 21 行由:

调用API ,必须传入系统参数和应用参数(需区分大小写)。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。

更新为以下内容:

调用API ,必须传入系统参数和应用参数(参数需区分大小写)。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。

2016年-06月-21日219.133.170.76 -
将 21 行由:

调用API ,必须传入系统参数和应用参数。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。

更新为以下内容:

调用API ,必须传入系统参数和应用参数(需区分大小写)。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:[server_url] 需通过系统API(get_server_url) 动态获取

更新为以下内容:

注意:[server_url] 需通过 系统API(get_server_url) 动态获取

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:[server_url]需通过系统API(get_server_url) 动态获取

更新为以下内容:

注意:[server_url] 需通过系统API(get_server_url) 动态获取

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:[server_url]需通过系统API(get_server_url) 动态获取

更新为以下内容:

注意:[server_url]需通过系统API(get_server_url) 动态获取

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:[server_url]需通过系统API(get_server_url) 动态获取

更新为以下内容:

注意:[server_url]需通过系统API(get_server_url) 动态获取

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 [server_url] ?

更新为以下内容:

注意:[server_url]需通过系统API(get_server_url) 动态获取

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 [=[server_url] ?

更新为以下内容:

注意:如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 server_url] ?

更新为以下内容:

注意:如何获取 [=[server_url] ?

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 [site.SystemApi[server_url?] ?

更新为以下内容:

注意:如何获取 server_url] ?

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 [server_url] ?

更新为以下内容:

注意:如何获取 [site.SystemApi[server_url?] ?

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 server_url

更新为以下内容:

注意:如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 [server_url] ?

更新为以下内容:

注意:如何获取 server_url

2016年-06月-21日219.133.170.76 -
改为:

http://[server_url]/Kisopenapi/router 如何获取 [server_url] ?

更新为以下内容:

http://[server_url]/Kisopenapi/router

注意:如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
将 7 行由:

http//[server_url]/Kisopenapi/router 如何获取 [server_url] ?

更新为以下内容:

http://[server_url]/Kisopenapi/router 如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
将 7 行由:

http://[server_url]/Kisopenapi/router 如何获取 [server_url] ?

更新为以下内容:

http//[server_url]/Kisopenapi/router 如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
将 7 行由:

http://[server_url]/Kisopenapi/router 如何获取 [server_url] ?

更新为以下内容:

http://[server_url]/Kisopenapi/router 如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
改为:

http://[server_url]/Kisopenapi/router

注意:如何获取 [server_url] ?

更新为以下内容:

http://[server_url]/Kisopenapi/router 如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:如何获取 [server_url] 是由系统类接口 get_server_url 动态获取

更新为以下内容:

注意:如何获取 [server_url] ?

2016年-06月-21日219.133.170.76 -
将 9 行由:

注意:[server_url]是由系统类接口 get_server_url 动态获取

更新为以下内容:

注意:如何获取 [server_url] 是由系统类接口 get_server_url 动态获取

2016年-06月-21日219.133.170.76 -
将 29 行由:
client_idstring应用ID,即开发者申请的应用ID
更新为以下内容:
client_idstring应用ID,即开发者申请的应用ID,如何获取client_id?
2016年-06月-21日219.133.170.76 -
将 30 行由:
access_tokenstring开发者access_token,有效期10分钟(随timestamp过期而过期,值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),auth_token由企业管理员在系统管理内生成的访问口令,如何获取访问口令?
更新为以下内容:
access_tokenstring开发者access_token,有效期10分钟(随timestamp过期而过期,值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),auth_token由企业管理员在系统管理内生成的访问口令,如何获取访问口令?
2016年-06月-21日219.133.170.76 -
将 30 行由:
access_tokenstring开发者access_token,有效期10分钟(随timestamp过期而过期,值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),auth_token由企业管理员在系统管理内生成的访问口令
更新为以下内容:
access_tokenstring开发者access_token,有效期10分钟(随timestamp过期而过期,值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),auth_token由企业管理员在系统管理内生成的访问口令,如何获取访问口令?
2016年-06月-21日219.133.170.76 -
将 31 行由:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.APP004088.acctplatform.AcctController.DealAcctPlatForm,如何使用Method?
更新为以下内容:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.APP004088.acctplatform.AcctController.DealAcctPlatForm,如何使用Method?
2016年-06月-21日219.133.170.76 -
将 31 行由:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.APP004088.acctplatform.AcctController.DealAcctPlatForm
更新为以下内容:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.APP004088.acctplatform.AcctController.DealAcctPlatForm,如何使用Method?
2016年-06月-21日219.133.170.76 -
将 28 行由:
netidstring网络ID ,从get_server_url 接口获取
更新为以下内容:
netidstring网络ID ,如何获取netid?
2016年-06月-21日219.133.170.76 -
将 27 行由:
eidstring企业号 金蝶KIS账务平台V14.0如何获得企业号
更新为以下内容:
eidstring企业号 金蝶KIS账务平台V14.0如何获得企业号
2016年-06月-16日219.133.170.76 -
改为:

[server_url]/Kisopenapi/router

注意:[server_url]是由系统类接口 get_server_url 动态获取,包含了http或https

更新为以下内容:

http://[server_url]/Kisopenapi/router

注意:[server_url]是由系统类接口 get_server_url 动态获取

2016年-06月-15日219.133.170.172 -
将 27 行由:
eidstring企业号
更新为以下内容:
eidstring企业号 金蝶KIS账务平台V14.0如何获得企业号
删除了第 76 行的以下内容:
2016年-06月-14日219.133.170.76 -
将 9 行由:

注意:[server_url]是由系统类接口 get_server_url 动态获取,包含了http://或https://

更新为以下内容:

注意:[server_url]是由系统类接口 get_server_url 动态获取,包含了http或https

2016年-06月-14日219.133.170.76 -
将 9 行由:

注意:[server_url]是由系统类接口 get_server_url 动态获取,包含了http或https

更新为以下内容:

注意:[server_url]是由系统类接口 get_server_url 动态获取,包含了http://或https://

2016年-06月-14日219.133.170.76 -
将 9 行由:

注意:[server_url]是由系统类接口 get_server_url 动态获取

更新为以下内容:

注意:[server_url]是由系统类接口 get_server_url 动态获取,包含了http或https

2016年-06月-14日219.133.170.76 -
将 31 行由:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.App004088.acctplatform.AcctController.DealAcctPlatForm
更新为以下内容:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.APP004088.acctplatform.AcctController.DealAcctPlatForm
2016年-06月-14日219.133.170.76 -
将 31 行由:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.App001804.acctplatform.AcctController.DealAcctPlatForm
更新为以下内容:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.App004088.acctplatform.AcctController.DealAcctPlatForm
2016年-06月-14日219.133.170.76 -
改为:

业务类API/Kisopenapi/router(API中控路由接口)

更新为以下内容:

业务类API

接口说明

业务类API中控路由入口

2016年-06月-14日219.133.170.76 -
将 28 行由:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.App001804.acctplatform.AcctController.DealAcctPlatForm
更新为以下内容:
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.App001804.acctplatform.AcctController.DealAcctPlatForm
2016年-06月-14日219.133.170.76 -
将 6 行由:

注意:[server_url]是由系统类接口 get_server_url? 动态获取

更新为以下内容:

注意:[server_url]是由系统类接口 get_server_url 动态获取

2016年-06月-14日219.133.170.76 -
将 6 行由:

注意:[server_url]是由系统类接口 get_server_url 动态获取

更新为以下内容:

注意:[server_url]是由系统类接口 get_server_url? 动态获取

2016年-06月-14日219.133.170.76 -
将 71 行由:
                ……
更新为以下内容:
              ……
2016年-06月-14日219.133.170.76 -
将 26 行由:
client_idstring开发商请求接口ID
更新为以下内容:
client_idstring应用ID,即开发者申请的应用ID
2016年-06月-14日219.133.170.76 -
将 4 行由:

https: //[server_url]/Kisopenapi/router

更新为以下内容:

[server_url]/Kisopenapi/router

2016年-06月-14日219.133.170.76 -
将 4 行由:

正式:https: //[server_url]/Kisopenapi/router

更新为以下内容:

https: //[server_url]/Kisopenapi/router

2016年-06月-14日219.133.170.76 -
改为:

正式:https: //[server_url]/Kisopenapi/router

测试:http://kd.cmcloud.cn:8080/Kisopenapi/router

更新为以下内容:

正式:https: //[server_url]/Kisopenapi/router

2016年-06月-14日127.0.0.1 -
在第 22 增加以下内容:
在第 37 增加以下内容:
在第 48 增加以下内容:
2016年-06月-14日127.0.0.1 -
改为:

业务类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 动态获取

改为:

使用token认证

更新为以下内容:

使用client_id、client_secret、access_token认证

改为:

调用API ,必须传入系统参数和应用参数。系统参数详细介绍如下;应用参数由于不同 API 各自不同,应用参数请参考具体的API 文档。

更新为以下内容:

调用API ,必须传入系统参数和应用参数。系统参数详细介绍如下;应用参数由于业务不同 API 各自不同,应用参数请参考具体的业务API 文档。

改为:
EIDstring企业号
NetIDstring网络ID ,网络ID,从get_server_url获取的NetID值
ClientIDstring开发者ID,即申请成为开发者分配的client_id
MethodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.uesapi.uesaccountmanger.getaccountlist
Timestampstring时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03。KD API服务端允许客户端请求时间误差为5分钟
Signstring签名,值为md5(Timetamp + EID + ClientID + Token + Method + State ),其中加号“+”为字符串连接符,Token是KIS账务平台系统管理内由KIS账务平台管理员生成,MD5的值为32位大写
Statestring请求端的状态值(由长度大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一),重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节
VerstringAPI协议版本,目前固定值为:2.0
IsEncryptstringCustData数据是否加密,Y为加密,N为不加密,默认为N
FromTagstring来源标识

应用参数数据包

更新为以下内容:
eidstring企业号
netidstring网络ID ,从get_server_url 接口获取
client_idstring开发商请求接口ID
access_tokenstring开发者access_token,有效期10分钟(随timestamp过期而过期,值为md5( timestamp + client_id + client_secret + auth_token + state ),其中加号“+”为字符串连接符,client_id 、client_secret是开发者在开放平台后台申请(务必保密,切勿泄露,一旦泄露请及时更新),auth_token由企业管理员在系统管理内生成的访问口令
methodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.App001804.acctplatform.AcctController.DealAcctPlatForm
timestampstring时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03,允许客户端请求时间误差为10分钟,需要urlencode,Get方式必须urlencode
verstringAPI协议版本,目前版本为 2.0,如:2.0
statestring请求端的状态值(由大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一)最多128字节,此值将作为返回值原样返回
fromtagstring来源标识
custdatastring应用参数数据包,应用API 业务json数据包,业务数据参数请参考API说明, 需urlencode处理

应用参数数据包custdata参数格式(业务参数注意大小写)

删除了 38-42 行中的以下内容
CustDatastring应用API 业务json数据包,业务数据参数请参考API说明

CustData参数格式

参数名称参数类型是否必填参数说明
改为:
Datastring业务端Json数据包,业务数据参数请参考具体业务API说明(即Method参数对应的API名称)
更新为以下内容:
每页多少条记录string业务端Json数据包,业务数据参数请参考具体业务API说明(即Method参数对应的API名称)
改为:
参数名称参数类型是否必填参数说明
Resultstring返回结果代码
Msgstring错误提示文本
DataJsonstring返回业务处理结果数据,详情参考具体API说明
更新为以下内容:
参数名称参数类型参数说明
Resultstring返回码:200 正常,大于200 异常
ErrMsgstring错误提示文本,如果Result大于200,会有相应的错误信息提,UTF-8编码,比如:
403 非法路由请求,access_token校验失败,client_secret或auth_token错误
303 超过数据流量
200 接口路由成功
201 接口路由失败,失败原因
若Result 小于 200,则为业务API的返回值
Statestring请求接口提交的state值,帮助开发者防范CSRF攻击
DataJsonstring业务端API的返回json数据
改为:
     “Result”:"",
     “Msg”:"",
     “DataJson”:{ …}
更新为以下内容:
     “Result”:200,
     “ErrMsg”:”success”,
     “State”:”xxxxxx”,
     “DataJson”:{

            “Result”:”业务API返回代码”,
            “ErrMsg”:”业务API返回值说明”,
            “Data”:””,
                ……
             }
删除了 73-75 行中的以下内容

如下:

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
2016年-04月-13日127.0.0.1 -
将 22 行由:

系统参数

更新为以下内容:

系统参数

将 36 行由:

应用参数数据包

更新为以下内容:

应用参数数据包

将 41 行由:

CustData参数格式

更新为以下内容:

CustData参数格式

将 52 行由:

返回结果

更新为以下内容:

返回结果

2016年-04月-13日127.0.0.1 -
将 4 行由:

正式:http://[server_url]/Webapi/router

更新为以下内容:

正式:http://'[server_url]'/Webapi/router

2016年-04月-13日127.0.0.1 -
将 59 行由:

格式:

更新为以下内容:

格式:

2016年-04月-13日127.0.0.1 -
改为:

业务类API中控路由接口

/Webapi/router

请求地址url

更新为以下内容:

业务类API中控路由接口(/Webapi/router)

请求地址url

将 10 行由:

请求方式

更新为以下内容:

请求方式

将 13 行由:

认证方式

更新为以下内容:

认证方式

将 16 行由:

调用限制

更新为以下内容:

调用限制

将 19 行由:

请求参数

更新为以下内容:

请求参数

2016年-04月-12日127.0.0.1 -
改为:
DataJsonstring返回业务处理结果数据,详情参考具体API说明
更新为以下内容:
DataJsonstring返回业务处理结果数据,详情参考具体API说明

格式:

{

     “Result”:"",
     “Msg”:"",
     “DataJson”:{ …}

}

如下:

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
2016年-04月-12日127.0.0.1 -
改为:
参数名称字段类型字段说明
errcodeinteger具体参考API返回状态值
descriptionstring结果或错误描述
更新为以下内容:
参数名称参数类型是否必填参数说明
EIDstring企业号
NetIDstring网络ID ,网络ID,从get_server_url获取的NetID值
ClientIDstring开发者ID,即申请成为开发者分配的client_id
MethodstringAPI接口名称(业务端接口名称,组成格式:kis.产品线简称.[功能模块|产品线简称].[控制器名称的前缀|接口方法名称]),形如:kis.uesapi.uesaccountmanger.getaccountlist
Timestampstring时间戳,格式为yyyy-mm-dd HH:mm:ss,例如:2014-03-14 16:52:03。KD API服务端允许客户端请求时间误差为5分钟
Signstring签名,值为md5(Timetamp + EID + ClientID + Token + Method + State ),其中加号“+”为字符串连接符,Token是KIS账务平台系统管理内由KIS账务平台管理员生成,MD5的值为32位大写
Statestring请求端的状态值(由长度大于等于16位大小写字母和数字组成,要求每次的随机数不能重复,必须唯一),重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节
VerstringAPI协议版本,目前固定值为:2.0
IsEncryptstringCustData数据是否加密,Y为加密,N为不加密,默认为N
FromTagstring来源标识

应用参数数据包

参数名称参数类型是否必填参数说明
CustDatastring应用API 业务json数据包,业务数据参数请参考API说明

CustData参数格式

参数名称参数类型是否必填参数说明
ProductIDstring产品ID
AccountDBstring帐套 (根据具体业务需要是否必填,比如帐务平台此处帐套为必填项)
UserIDstring用户ID
PassWordstring密码
CurrentPagestring当前页
ItemsOfPagestring每页多少条记录
Datastring业务端Json数据包,业务数据参数请参考具体业务API说明(即Method参数对应的API名称)

返回结果

参数名称参数类型是否必填参数说明
Resultstring返回结果代码
Msgstring错误提示文本
DataJsonstring返回业务处理结果数据,详情参考具体API说明
2016年-04月-12日127.0.0.1 -
在 1-27 行中增加以下内容:

业务类API中控路由接口

/Webapi/router

请求地址url

正式:http://[server_url]/Webapi/router

测试:http://kd.cmcloud.cn:8080/Webapi/router

注意:[server_url]是从接口 /Kisoemapi/get_server_url 获取的ServerUrl参数值

请求方式

Get/Post

认证方式

使用token认证

调用限制

有每次请求数据流量限制

请求参数

调用API ,必须传入系统参数和应用参数。系统参数详细介绍如下;应用参数由于不同 API 各自不同,应用参数请参考具体的API 文档。

系统参数

参数名称字段类型字段说明
errcodeinteger具体参考API返回状态值
descriptionstring结果或错误描述