这里的异步处理指的是:从客户端提交的请求可以要求后台服务器按异步处理。客户端提交请求后,不用等待后台处理完即返回一个回执号(TaskID),每次的请求都会产生一个不一样的回执号。客户端再需要的时候,可根据回执号查询那次请求的处理进度。
1.提交异步处理的请求
Post URL:https://kisgz.kingdee.com/Kisopenapi/router/
Post数据:
eid=1884366
&netid=1884366317841
&client_id=1402576015
&method=kis.APP004088.acctplatform.AcctController.DealAcctPlatForm
×tamp=2016-06-20 17:23:57
&ver=2.0
&access_token=C1C2F1B9362E152A8450280EF404605B
&state=uiwcRcIfqgTkQuRY
&custdata={
"ProductID":"S1S013S001",
"AccountDB":"KIS_Sample",
"Data":{
"Action":"SyncUser",
"Async":true,
"Recordset":[
{
"FID":"U001",
"FUserName":"张三01",
"FPwd":"123"
},
{
"FID":"U002",
"FUserName":"张三02",
"FPwd":""
}
]
}
}
返回: {
"Result": 200, "ErrMsg": "success", "State": "uiwcRcIfqgTkQuRY", "DataJson": { "Result": "200", "ErrMsg": "", "AccountDB": null, "TotalPage": "0", "CurrentPage": "0", "ItemsOfPage": "0", "Data": "{\"TaskID\":2}" }
}
返回中的Data:
{
"TaskID": 2
}
参数名称 | 参数类型 | 参数说明 |
---|---|---|
TaskID | long | 回执ID |
请求发送成功,此次请求拿到的回执号(TaskID)为2,后面可随时根据此回执号查询此次请求的处理情况
2.查看异步处理的结果
Post URL:https://kisgz.kingdee.com/Kisopenapi/router/
Post数据:
eid=1884366
&netid=1884366317841
&client_id=1402576015
&method=kis.APP004088.acctplatform.AcctController.DealAcctPlatForm
×tamp=2016-06-20 17:56:34
&ver=2.0
&access_token=8846FC9CAAEB31C684E6F5867A57C71B
&state=vuxosWBRr1UwrbSF
&custdata={
"ProductID":"S1S013S001", "AccountDB":"KIS_Sample", "Data":{ "Action":"GetRlt", "Recordset":[2] }
}
如果要查多个回执号的处理进度,可用逗号隔开,如查2和3号,就用 "Recordset":[2,3]
返回: {
"Result": 200, "ErrMsg": "success", "State": "vuxosWBRr1UwrbSF", "DataJson": { "Result": "200", "ErrMsg": "", "AccountDB": null, "TotalPage": "0", "CurrentPage": "0", "ItemsOfPage": "0", "Data": "[{\"TaskID\":2,\"State\":2,\"Description\":\"\\u5904\\u7406\\u6210\\u529F\",\"Data\":null,\"ErrMsg\":\"\"}]" }
}
返回中的Data: [
{
"TaskID": 2,
"State": 2,
"Description": "处理成功",
"Data": null,
"ErrMsg": ""
}
]
参数名称 | 参数类型 | 参数说明 |
---|---|---|
TaskID | long | 回执ID |
State | long | 处理结果状态值: 0-排队等待处理 1-正在处理 2-处理成功 3-处理失败 4-查不到任务 |
Description | String | 处理结果描述,对State值的一对一描述 |
ErrMsg | String | 错误描述,State=3时有效 |