本接口用于删除图像搜索实例中的图片信息。
调用该接口需要在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 编码后的值