平台概述

开发者协议

API调用约定

接入指南

认证授权

返回结果

API详情

系统API

业务网关API

业务API详情

账务平台登录接口

常见问题

安全保障

后台异步处理请求示例

功能说明

这里的异步处理指的是：从客户端提交的请求可以要求后台服务器按异步处理。客户端提交请求后，不用等待后台处理完即返回一个回执号（TaskID），每次的请求都会产生一个不一样的回执号。客户端再需要的时候，可根据回执号查询那次请求的处理进度。

示例

1.提交异步处理的请求

Post URL：https://kisgz.kingdee.com/Kisopenapi/router/
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",
        "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

}

返回参数说明

参数名称参数类型参数说明
TaskIDlong回执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
&timestamp=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": ""
    }

]

返回参数说明

参数名称参数类型参数说明
TaskIDlong回执ID
Statelong处理结果状态值：
0-排队等待处理
1-正在处理
2-处理成功
3-处理失败
4-查不到任务
DescriptionString处理结果描述，对State值的一对一描述
ErrMsgString错误描述，State=3时有效