本接口用于刪除圖像搜索實例中的圖片信息。
調用該接口需要在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 編碼后的值