本接口用于删除图像搜索实例中的图片信息。

调用该接口需要在URL参数中传入instanceName参数,表示要操作的实例,其它参数拼接成系统指定的格式串,然后通过Body进行传输。请求路径为/item/delete

请求参数

  • URL中参数
    名称 类型 是否必须 描述
    instanceName String 操作实例名称。
  • Body中参数
    名称 类型 是否必须 描述
    item_id String 要删除商品或者图片的ID。
    pic_list List 要删除的图片名称列表,不指定则默认删除item_id下的所有图片。
  • Body构造方法
    Body的格式如下:
    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 错误信息。

返回格式

{
    "Message":"success",
    "RequestId":"73B5133C-84EE-4F0A-B972-23CCCBFB7CD5",
    "Success":true,
    "Code":0
}

示例

假定某个用户要删除实例goodssearch中item_id为1000,名称为shoes1.jpg和shoes2.jpg的两张图片。最终请求方式如下:
URL: /item/delete?instaneName=goodssearch
POST Body:
item_id,0,4#pic_list,4,37^1000c2hvZXMxLmpwZw==,c2hvZXMyLmpwZw==
说明:其中 c2hvZXMyLmpwZw== 表示 shoes1.jpg 进行 base64 编码后的值, c2hvZXMxLmpwZw== 表示 shoes2.jpg 进行 base64 编码后的值