本文介绍查询异步任务结果GetAsyncJobResult的语法及示例。
功能描述
异步接口调用API接口后,返回的并不是真正的请求结果,您需要保存返回结果中的RequestId,然后调用GetAsyncJobResult来获取真正的请求结果。
说明
- 异步任务的文件有过期时间,有效期是30分钟。如需长期使用,需及时将文件下载到本地服务器或存储在OSS中。有关OSS更多操作信息,请参见上传文件。
- 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
当前文字识别类目中视频文字识别(RecognizeVideoCharacter)为异步接口,需要调用GetAsyncJobResult来获取真实的请求结果。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetAsyncJobResult | 系统规定参数。取值:GetAsyncJobResult。 |
JobId | String | 是 | E75FE679-0303-4DD1-8252-1143B4FA8A27 | 异步接口返回的RequestId,输入后可以查询异步接口的真实请求结果。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | A1F44EC4-118D-4A03-B213-F908F36F7DAA | 请求ID。 |
Data | Object | 返回的数据内容。 |
|
Status | String | PROCESS_SUCCESS | 异步任务状态。包括:
|
ErrorMessage | String | paramsIllegal | 异步任务错误码信息。 |
Result | String | {\"Content\":\"<div > <h2 > 2017 年 3 月 40 多家陶企上榜失信被执行人名单 </h2><div > 1 月 7 日,陶卫网记者根据最高人民法院及各地法院发布的失信被执行人信息统计,2019 年 12 月全国各地有 112 家陶瓷企业被列入“失信被执行人”名单,名单涉及 21 个省(市)。此次名单中,广东省的失信陶企多达 28 家。 </div><div > 据统计,这些“失信被执行人”的上榜原因主要为债务纠纷,欠款不还,大部分为拖欠供应商货款、工资、员工赔偿、银行贷款以及融资租赁租金等,也有涉及运输、燃气等费用,小部分企业涉及承担债务连带清偿责任。 </div><table border=1> <tr><td > 公司名称 </td><td > 最新失信发布时间 </td><td > 累计失信次数 </td> </tr> <tr><td > 潮州市澳士通陶瓷实业有限公司 </td><td > 3 月 15 日 </td><td > 1 次 </td> </tr> <tr><td > 肇庆市德圣陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 6 次 </td> </tr> <tr><td > 清远市港龙陶瓷有限公司 </td><td > 3 月 10 日 </td><td > 28 次 </td> </tr> <tr><td > 广西金沙江陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 3 次 </td> </tr> <tr><td > 宜丰县凯扬陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 11 次 </td> </tr> <tr><td > 江西领先精工陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 23 次 </td> </tr> <tr><td > 高安弘建陶瓷有限公司 </td><td > 3 月 28 日 </td><td > 5 次 </td> </tr></table>\"} | 异步任务返回的真实请求结果。 |
ErrorCode | String | InvalidParameter | 异步任务错误码。 |
JobId | String | 49E2CC28-ED1D-4CC5-854D-7D0AE2B20976 | 异步任务ID。 |
SDK参考
阿里云视觉AI能力推荐使用SDK调用,支持多种编程语言,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览。
示例
请求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=GetAsyncJobResult //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&JobId=E75FE679-0303-4DD1-8252-1143B4FA8A27
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>A1F44EC4-118D-4A03-B213-F908F36F7DAA</RequestId>
<Data>
<Status>PROCESS_SUCCESS</Status>
<ErrorMessage>paramsIllegal</ErrorMessage>
<Result>{\"Content\":\"<div > <h2 > 2017 年 3 月 40 多家陶企上榜失信被执行人名单 </h2><div > 1 月 7 日,陶卫网记者根据最高人民法院及各地法院发布的失信被执行人信息统计,2019 年 12 月全国各地有 112 家陶瓷企业被列入“失信被执行人”名单,名单涉及 21 个省(市)。此次名单中,广东省的失信陶企多达 28 家。 </div><div > 据统计,这些“失信被执行人”的上榜原因主要为债务纠纷,欠款不还,大部分为拖欠供应商货款、工资、员工赔偿、银行贷款以及融资租赁租金等,也有涉及运输、燃气等费用,小部分企业涉及承担债务连带清偿责任。 </div><table border=1> <tr><td > 公司名称 </td><td > 最新失信发布时间 </td><td > 累计失信次数 </td> </tr> <tr><td > 潮州市澳士通陶瓷实业有限公司 </td><td > 3 月 15 日 </td><td > 1 次 </td> </tr> <tr><td > 肇庆市德圣陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 6 次 </td> </tr> <tr><td > 清远市港龙陶瓷有限公司 </td><td > 3 月 10 日 </td><td > 28 次 </td> </tr> <tr><td > 广西金沙江陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 3 次 </td> </tr> <tr><td > 宜丰县凯扬陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 11 次 </td> </tr> <tr><td > 江西领先精工陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 23 次 </td> </tr> <tr><td > 高安弘建陶瓷有限公司 </td><td > 3 月 28 日 </td><td > 5 次 </td> </tr></table>\"}</Result>
<ErrorCode>InvalidParameter</ErrorCode>
<JobId>49E2CC28-ED1D-4CC5-854D-7D0AE2B20976</JobId>
</Data>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "A1F44EC4-118D-4A03-B213-F908F36F7DAA",
"Data" : {
"Status" : "PROCESS_SUCCESS",
"ErrorMessage" : "paramsIllegal",
"Result" : "{\\\"Content\\\":\\\"<div > <h2 > 2017 年 3 月 40 多家陶企上榜失信被执行人名单 </h2><div > 1 月 7 日,陶卫网记者根据最高人民法院及各地法院发布的失信被执行人信息统计,2019 年 12 月全国各地有 112 家陶瓷企业被列入“失信被执行人”名单,名单涉及 21 个省(市)。此次名单中,广东省的失信陶企多达 28 家。 </div><div > 据统计,这些“失信被执行人”的上榜原因主要为债务纠纷,欠款不还,大部分为拖欠供应商货款、工资、员工赔偿、银行贷款以及融资租赁租金等,也有涉及运输、燃气等费用,小部分企业涉及承担债务连带清偿责任。 </div><table border=1> <tr><td > 公司名称 </td><td > 最新失信发布时间 </td><td > 累计失信次数 </td> </tr> <tr><td > 潮州市澳士通陶瓷实业有限公司 </td><td > 3 月 15 日 </td><td > 1 次 </td> </tr> <tr><td > 肇庆市德圣陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 6 次 </td> </tr> <tr><td > 清远市港龙陶瓷有限公司 </td><td > 3 月 10 日 </td><td > 28 次 </td> </tr> <tr><td > 广西金沙江陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 3 次 </td> </tr> <tr><td > 宜丰县凯扬陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 11 次 </td> </tr> <tr><td > 江西领先精工陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 23 次 </td> </tr> <tr><td > 高安弘建陶瓷有限公司 </td><td > 3 月 28 日 </td><td > 5 次 </td> </tr></table>\\\"}",
"ErrorCode" : "InvalidParameter",
"JobId" : "49E2CC28-ED1D-4CC5-854D-7D0AE2B20976"
}
}
Result反序列化
将上面Result反序列化展示如下。
{
"Content": "<div > <h2 > 2017 年 3 月 40 多家陶企上榜失信被执行人名单 </h2><div > 1 月 7 日,陶卫网记者根据最高人民法院及各地法院发布的失信被执行人信息统计,2019 年 12 月全国各地有 112 家陶瓷企业被列入“失信被执行人”名单,名单涉及 21 个省(市)。此次名单中,广东省的失信陶企多达 28 家。 </div><div > 据统计,这些“失信被执行人”的上榜原因主要为债务纠纷,欠款不还,大部分为拖欠供应商货款、工资、员工赔偿、银行贷款以及融资租赁租金等,也有涉及运输、燃气等费用,小部分企业涉及承担债务连带清偿责任。 </div><table border=1> <tr><td > 公司名称 </td><td > 最新失信发布时间 </td><td > 累计失信次数 </td> </tr> <tr><td > 潮州市澳士通陶瓷实业有限公司 </td><td > 3 月 15 日 </td><td > 1 次 </td> </tr> <tr><td > 肇庆市德圣陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 6 次 </td> </tr> <tr><td > 清远市港龙陶瓷有限公司 </td><td > 3 月 10 日 </td><td > 28 次 </td> </tr> <tr><td > 广西金沙江陶瓷有限公司 </td><td > 3 月 14 日 </td><td > 3 次 </td> </tr> <tr><td > 宜丰县凯扬陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 11 次 </td> </tr> <tr><td > 江西领先精工陶瓷发展有限公司 </td><td > 3 月 29 日 </td><td > 23 次 </td> </tr> <tr><td > 高安弘建陶瓷有限公司 </td><td > 3 月 28 日 </td><td > 5 次 </td> </tr></table>"
}
错误码
关于查询异步任务结果的错误码,详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。