查询个税截图检测任务的状态和异常项列表。
接口说明
请求说明
轮询建议:建议轮询间隔不小于 5 秒。任务处于
running状态时,更密集地轮询不会让结果更快返回。总超时时间:任务创建满 30 分钟仍未拿到结果时,任务被判为
failed,Message 为poll timeout: no result within 30m0s。终态处理:
succeeded和failed为任务的最终状态,此后结果不再变化。Items 为空数组:表示未发现异常项,不是错误。
Coordinates 可能为空数组:部分异常是全图性质的(例如整张图的质量问题),无法定位到具体矩形框,此时
Coordinates为空数组,但该异常项本身依然有效、依然需要呈现给用户。Stage 开放取值:后续版本可能新增
Stage取值,请按"未知取值原样展示"的方式实现,不要对Stage做白名单校验或据此过滤异常项。quality 阶段:
Stage为quality表示图像质量过低,检测结果可信度低,建议提示用户重新提交清晰的原始截图后再次检测。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClientToken |
string |
否 |
幂等参数 |
5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
| TaskId |
string |
是 |
任务 ID,由 |
f47ac10b-58cc-4372-a567-0e02b2c3d479 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
A1B2C3D4-E5F6-7890-ABCD-EF1234567890 |
| Success |
boolean |
请求是否成功。 |
true |
| Message |
string |
任务失败时的失败原因 |
poll timeout: no result within 30m0s |
| HttpStatusCode |
integer |
HTTP 状态码。 请求成功时返回 200。 |
200 |
| Code |
string |
业务错误码。 请求成功时返回 "OK"。 |
OK |
| TaskId |
string |
任务 ID。 |
f47ac10b-58cc-4372-a567-0e02b2c3d479 |
| Status |
string |
任务状态。 取值: |
succeeded |
| Items |
array<object> |
检出的异常项列表。 仅在 |
|
|
array<object> |
异常项 |
||
| Stage |
string |
检出该异常的检测阶段标识。 |
stage2 |
| AbnormalItem |
string |
异常项的文字描述。 |
月份序列异常: 2022-05 -> 2022-11(应为降序或相等) |
| Coordinates |
array<object> |
该异常项在图中的矩形框位置,可能为空数组(全图性质异常) |
|
|
object |
区域坐标。 |
||
| X1 |
integer |
左上角横坐标(像素) |
928 |
| Y1 |
integer |
左上角纵坐标(像素) |
792 |
| X2 |
integer |
矩形框右下角横坐标(像素)。 |
1147 |
| Y2 |
integer |
矩形框右下角纵坐标(像素)。 |
847 |
| Result |
string |
下游检测结果原文(extend.result 字符串),便于排错与透传新增字段 |
{"items": []} |
示例
正常返回示例
JSON格式
{
"RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
"Success": true,
"Message": "poll timeout: no result within 30m0s",
"HttpStatusCode": 200,
"Code": "OK",
"TaskId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"Status": "succeeded",
"Items": [
{
"Stage": "stage2",
"AbnormalItem": "月份序列异常: 2022-05 -> 2022-11(应为降序或相等)",
"Coordinates": [
{
"X1": 928,
"Y1": 792,
"X2": 1147,
"Y2": 847
}
]
}
],
"Result": "{\"items\": []}"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。