图片信息更新请求
图片信息更新请求接口用于更新图片入库时Info字段的内容
图片及接口的通用说明详见 服务概述
1). 接口地址
https://aiapi.jd.com/jdai/image_update
2). 请求方式
post
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请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
collection_name | string | 是 | "food" | 库名 |
docs | array | 是 | [...] | 更新列表 |
docs参数信息
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
image_name | string | 是 | "Milk_salt_soda_v1" | 入库时自定义的图片唯一标识 |
info | string | 是 | "{\"Ingredients\":\"wheat flour, milkfat, edible salt\", \"price\":\"12.0\"}" | 需要更新到的备注信息(将会覆盖旧备注信息) |
返回参数
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" | 参照概述-业务错误信息 |
succeeded_list | array | [...] | 更新成功的图片信息列表,仅当status_code为0时存在 |
failed_list | array | [...] | 更新失败列表,仅当status_code为0时存在 |
succeeded_list 参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
image_name | string | "Milk_salt_soda_v1" | 图片名 |
info | string | "{\"Ingredients\":\"wheat flour, milkfat, edible salt\", \"price\":\"12.0\"}" | 更新后的图片备注信息 |
failed_list 参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
image_name | string | "Egg" | 图片名 |
message | string | "NO_RELATIVE_IMAGE" | 失败信息 |
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",
"succeeded_list": [
{
"image_name": "Milk_salt_soda_v1",
"info": "{\"Ingredients\":\"wheat flour, milkfat, edible salt\", \"price\":\"12.0\"}"
},
……
],
"failed_list": [
{
"image_name": "Egg",
"message": "NO_RELATIVE_IMAGE"
},
……
]
}
}