任务状态查询请求

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

1). 接口地址

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

2). 请求方式

 get

3). 请求参数

(1) query请求参数

公共请求参数

名称 类型 必填 示例值 描述
appkey string 80d2b762ecb86593f9668526920f46c 您的appkey,可在买家中心控制台中获取
timestamp long 1541491668060 请求的时间戳,精确到毫秒,timestamp有效期5分钟
sign string 2e148773a0337a8f2200ba90d445f083 签名,根据规则MD5(sectetkey+timestamp)
(2) header请求参数

业务请求参数

名称 类型 必填 示例值 描述
Content-Type string application/x-www-form-urlencoded 编码格式
(3) body请求参数

业务请求参数

名称 类型 必填 示例值 描述
task_id string "92374205376234/food/1573113266.7619262" 任务id(图片入库请求返回)

返回参数

1). 公共返回参数

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

2). 业务返回参数

result参数信息

名称 类型 示例值 描述
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" 失败信息

3). 返回示例

Status Code: 200
Time:746ms
Date:Fri 15 Mar 2019 08:20:38 GMT
Body:
{
  "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"
      }
    ]
  }
}
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""