平台概述

开发者协议

API调用约定

接入指南

认证授权

返回结果

API详情

系统API

业务网关API

业务API详情

账务平台登录接口

常见问题

安全保障

Site.后台异步处理请求示例的历史版本

隐藏细微更改 - 以实际显示效果显示

2016年-06月-21日 被 219.133.170.76 -
将 58 行由：
!!%second%参数说明
更新为以下内容：
!!%second%返回参数说明
将 116 行由：
!!%second%参数说明
更新为以下内容：
!!%second%返回参数说明
恢复
2016年-06月-21日 被 219.133.170.76 -
在 58-61 行中增加以下内容：
!!%second%参数说明
|| class=table-of-content
||!参数名称 ||!参数类型||!参数说明
||TaskID||long||回执ID
恢复
2016年-06月-21日 被 219.133.170.76 -
改为：
]
更新为以下内容：
]

!!%second%参数说明
|| class=table-of-content
||!参数名称 ||!参数类型||!参数说明
||TaskID||long||回执ID
||State||long||处理结果状态值：\\
0-排队等待处理\\
1-正在处理\\
2-处理成功\\
3-处理失败\\
4-查不到任务
||Description||String||处理结果描述，对State值的一对一描述
||ErrMsg||String||错误描述，State=3时有效
恢复
2016年-06月-20日 被 219.133.170.76 -
将 8 行由：
Post URL：http://kd.cmcloud.cn/Kisoemapi/get_server_url\\
更新为以下内容：
Post URL：https://kisgz.kingdee.com/Kisopenapi/router/\\
将 65 行由：
Post URL：http://kd.cmcloud.cn/Kisoemapi/get_server_url\\
更新为以下内容：
Post URL：https://kisgz.kingdee.com/Kisopenapi/router/\\
恢复
2016年-06月-20日 被 219.133.170.76 -
在第 5 增加以下内容：
!!%second%示例
恢复
2016年-06月-20日 被 219.133.170.76 -
在 1-2 行中增加以下内容：
!后台异步处理请求示例
!!%second%功能说明
恢复
2016年-06月-20日 被 219.133.170.76 -
在 1-107 行中增加以下内容：
这里的异步处理指的是：从客户端提交的请求可以要求后台服务器按异步处理。客户端提交请求后，不用等待后台处理完即返回一个回执号（TaskID），每次的请求都会产生一个不一样的回执号。客户端再需要的时候，可根据回执号查询那次请求的处理进度。

'''1.提交异步处理的请求'''

Post URL：http://kd.cmcloud.cn/Kisoemapi/get_server_url\\
Post数据： \\
eid=1884366\\
&netid=1884366317841\\
&client_id=1402576015\\
&method=kis.APP004088.acctplatform.AcctController.DealAcctPlatForm\\
&timestamp=2016-06-20 17:23:57\\
&ver=2.0\\
&access_token=C1C2F1B9362E152A8450280EF404605B\\
&state=uiwcRcIfqgTkQuRY\\
&custdata={
    "ProductID":"S1S013S001",
    "AccountDB":"KIS_Sample",
    "Data":{
        "Action":"SyncUser",
        %red%"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": %blue%2%%
}

请求发送成功，此次请求拿到的回执号（TaskID）为2，后面可随时根据此回执号查询此次请求的处理情况



'''2.查看异步处理的结果'''

Post URL：http://kd.cmcloud.cn/Kisoemapi/get_server_url\\
Post数据： \\
eid=1884366\\
&netid=1884366317841\\
&client_id=1402576015\\
&method=kis.APP004088.acctplatform.AcctController.DealAcctPlatForm\\
&timestamp=2016-06-20 17:56:34\\
&ver=2.0\\
&access_token=8846FC9CAAEB31C684E6F5867A57C71B\\
&state=vuxosWBRr1UwrbSF\\
&custdata={
    "ProductID":"S1S013S001",
    "AccountDB":"KIS_Sample",
    "Data":{
        "Action":"%red%GetRlt%%",
        "Recordset":[%blue%2%%]
    }
}\\
如果要查多个回执号的处理进度，可用逗号隔开，如查2和3号，就用 "Recordset":[%blue%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,
        "%red%State%%": 2,
        "Description": "处理成功",
        "Data": null,
        "ErrMsg": ""
    }
]
恢复