刪除多個目錄項
刪除
/目錄/ {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。 |