GetImageIncomeTaxDetectionTaskResult - 查询个税截图检测结果

更新时间:
复制 MD 格式

查询个税截图检测任务的状态和异常项列表。

接口说明

请求说明

  • 轮询建议:建议轮询间隔不小于 5 秒。任务处于 running 状态时,更密集地轮询不会让结果更快返回。

  • 总超时时间:任务创建满 30 分钟仍未拿到结果时,任务被判为 failed,Message 为 poll timeout: no result within 30m0s

  • 终态处理succeededfailed 为任务的最终状态,此后结果不再变化。

  • Items 为空数组:表示未发现异常项,不是错误。

  • Coordinates 可能为空数组:部分异常是全图性质的(例如整张图的质量问题),无法定位到具体矩形框,此时 Coordinates 为空数组,但该异常项本身依然有效、依然需要呈现给用户。

  • Stage 开放取值:后续版本可能新增 Stage 取值,请按"未知取值原样展示"的方式实现,不要对 Stage 做白名单校验或据此过滤异常项。

  • quality 阶段Stagequality 表示图像质量过低,检测结果可信度低,建议提示用户重新提交清晰的原始截图后再次检测。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

ClientToken

string

幂等参数

5A2CFF0E-5718-45B5-9D4D-70B3FF3898

TaskId

string

任务 ID,由 CreateImageIncomeTaxDetectionTask 返回。

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

任务状态。 取值:running(执行中)、succeeded(已完成)、failed(失败)。

succeeded

Items

array<object>

检出的异常项列表。 仅在 Statussucceeded 时返回。为空数组表示未发现异常项。

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.

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情