全部产品
云市场

新增图片

更新时间:2018-07-11 16:40:19

描述

本接口用于往实例中新增各种图片信息,需要在 Url 参数中传入 instanceName 参数,表示要操作的实例,其它参数拼接成系统指定的格式串,然后通过Body进行传输。

请求路径

/item/add

请求参数

URL中参数

名称 类型 是否必须 描述
instanceName String 操作实例名称。

Body中参数

名称 类型 是否必须 描述
item_id String 商品或者图片的 id。
cat_id String 商品搜索是,通用搜索否 类目 Id。
crop boolean 是否需要进行主体识别,默认为true。
region String 图片的主体区域,格式为 x1,x2,y1,y2, 其中 x1,y1 是左上角的点,
x2,y2是右下角的点,默认自动识别主体区域。
cust_content String 用户自定义的内容。
pic_list List 图片名称列表。
pic_map Map 每个图片对应的内容。

Body构造方法

Body的格式如下:

  1. key1,key1_start_offset,key1_end_offset#...#keyn,keyn_start_offset,keyn_end_offset^key1_content...keyn_content

body 整体来看,分成两个部分。^ 前面表示Meta部分,^ 后面表示Content部分。Meta部分描述有哪些 Key ,以及每个 Key 对应值在 Content 中的偏移。多个 Key 之间用 # 号分隔,单个 Key 内部用英文逗号分隔。Key 后面的两个数字分别表示 Key 在 Content 中的起始位置和结束位置。此外,对于 pic_list 中每个图片名称需要进行 base64 编码。多个图片名称之间用逗号拼接成一个字符串。pic_map 中每一个 key 和 pic_list 中的对应,并且 pic_map 中的图片内容也需要进行 base64 编码。

返回参数

名称 类型 描述
Success Boolean 请求是否成功
RequestId String 请求的 ID
Code int 错误码,0 表示成功,非 0 表示失败
Message String 错误信息

返回格式:

  1. {
  2. "Message":"success",
  3. "RequestId":"73B5133C-84EE-4F0A-B972-23CCCBFB7CD5",
  4. "Success":true,
  5. "Code":0
  6. }

示例

假定某个用户要往实例 goodssearch 中添加一个商品。item_id 为 1000,cat_id 为 0, 商品的自定义内容 cust_content 为 {“key1”:”value1”}。商品中要添加的图片名称为 shoes1.jpg,图片内容为 pic_content1,以及 shoes2.jpg,图片内容为 pic_content2。最终请求方式如下:

  1. URL: /item/add?instaneName=goodssearch
  2. POST Body:
  3. cust_content,0,17#item_id,17,21#c2hvZXMyLmpwZw==,21,37#cat_id,37,38#pic_list,38,71#c2hvZXMxLmpwZw==,71,87^{"key1":"value1"}1000cGljX2NvbnRlbnQy0c2hvZXMyLmpwZw==,c2hvZXMxLmpwZw==cGljX2NvbnRlbnQx
  4. 说明:其中 c2hvZXMyLmpwZw== 表示 shoes1.jpg 进行 base64 编码后的值, c2hvZXMxLmpwZw== 表示 shoes2.jpg 进行 base64 编码后的值