任务状态查询请求
图片入库时是异步的任务,故在调入库接口入库后,可以通过此接口查询入库任务是否完成。入库时接口会返回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"
}
]
}
}