跳到內容

刪除多個目錄項

刪除

/目錄/ {catalog_name} /項目

使用該端點刪除多個項目在你的目錄。

每個請求可以支持多達50項。這個端點是異步的。

速率限製

這個端點的共享速率限製每分鍾100個請求所有異步目錄項端點之間,作為記錄API率限製

路徑參數

參數 要求 數據類型 描述
catalog_name 要求 字符串 目錄的名稱。

請求參數

參數 要求 數據類型 描述
項目 要求 數組 一個數組,其中包含項目對象。項目應該包含一個對象id引用釺應該刪除的條目。多達50項對象允許每個請求。

示例請求


            
1 2 3 4 5 6 7 8 9 10
curl——位置請求刪除的https://rest.iad - 03. braze.com/catalogs/restaurants/items \——頭的application / json內容類型:\——頭的授權:無記名YOUR-REST-API-KEY \ data-raw”{“物品”:[{" id ": " restaurant1}, {" id ": " restaurant2}, {" id ": " restaurant3}]}”

響應

有三個狀態代碼這個端點的響應:202年,400年,404年

例子成功響應

狀態代碼202年可以返回下麵的身體反應。


            
1 2 3
{“消息”:“成功”}

例子錯誤響應

狀態代碼400年可以返回下麵的身體反應。指故障排除你可能會遇到更多信息錯誤。


            
1 2 3 4 5 6 7 8 9 10 11
{“錯誤”:({“id”:“items-missing-ids”,“消息”:“有1項(s),沒有id”,“參數”:[],“parameter_values”:[]}),“消息”:“無效的請求”,}

故障排除

下表列出了可能的返回錯誤及其相關故障排除步驟。

錯誤 故障排除
catalog-not-found 檢查目錄名稱是有效的。
ids-too-large 項id不能超過250個字符。
ids-not-unique 檢查條目id請求中是獨一無二的。
ids-not-strings 項id必須是string類型的。
items-missing-ids 有項目,沒有項目id。檢查每個項目都有一個條目ID。
無效id 項id隻能包括字母、數字、連字符、下劃線。
request-includes-too-many-items 你的要求太多了。每個請求項極限是50。
這個頁麵是有用嗎?
新東西!
Baidu
map