产品文档

通用图片搜索

帮助中心 > 产品文档 > 通用图片搜索 > 任务状态查询请求

任务状态查询请求

图片入库时是异步的任务,故在调入库接口入库后,可以通过此接口查询入库任务是否完成。入库时接口会返回task_id,基于task_id可以查询该任务的状态。
图片及接口的通用说明详见 接口概述

1. 接口地址 :

https://aiapi.jdcloud.com/jdai/task

2. 请求方式:

https get aiapi.jdcloud.com/jdai/task

3. 请求参数


##(1)header请求参数 业务请求参数

名称 类型 必填 示例值 描述
Content-Type String application/json 表示请求JSON格式的文本信息
Authorization string JDCLOUD2-HMAC-SHA256Credential=access... 签名
(2)query请求参数
名称 类型 必填 示例值 描述
task_id string "92374205376234/food/1573113266.7619262" 任务id(图片入库请求返回)
(3)body请求参数

4. 请求代码示例

建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见sdk的使用方法

返回说明

1、返回参数

(1)公共返回参数
名称 类型 示例值 描述
code string 1000 参见错误码-系统级错误码
charge boolean false 或 true false:不扣费, true:扣费
remain long 1305 按天计算剩余调用次数
msg string 查询成功 参见错误码-系统级错误码
result object {...} 查询结果
(2)业务返回参数

服务器返回的识别结果采用 JSON 格式:

名称 类型 示例值 描述
status_code int 0 参照概述-业务错误码
message string "SUCCESS" 参照概述-业务错误信息
task_status string "FINISHED" 任务状态,有"PROCESSING", "FINISHED"两种。其中FINISHED仅表示任务处理完成,各图片是否入库成功需要查看succeeded_list和failed_list
succeeded_list array[string] ["Milk_salt_soda_v1"] 入库成功的图片名列表,仅当status_code为0时存在
failed_list array [...] 入库失败列表,仅当status_code为0时存在

failed_list 参数信息

名称 类型 示例值 描述
image_name string "Egg" 图片名
message string "NO_AVAILIABLE_FEATURE" 失败信息

2、返回示例


{
  "code": "10000",
  "charge": false,
  "remainTimes": 4998,
  "remainSeconds": -1,
  "msg": "查询成功",
  "result": {
    "status_code": 0,
    "message": "SUCCESS",
    "task_status": "processing",
    "succeeded_list": [ ],
    "pending_list": [
      "Milk_salt_soda_v1",
      ……
    ],
    "failed_list": [
      {
        "image_name": "Egg",
        "message": "NO_AVAILIABLE_FEATURE"
      }
    ]
  }
}
更新时间:2020-07-16 18:15:46
文档反馈 docs feedback