刪除用戶API

最新更新:2024-07-10

前提

一旦刪除用戶,就無法將其恢復。已刪除的用戶只能在以下情況下再次收到消息:

  • Web:清除瀏覽器 cookie,然後返回您的網站。
  • 移動設備:再次打開應用程式或者卸載重裝App以重新進行SDK初始化。建議您在應用程式中更新最新版本的SDK。。

刪除前的建議

  1. 查詢標籤和別名信息:通過標籤別名API,查詢要刪除的registration_id目前綁定的別名和標籤信息。

  2. 檢查受眾群體:仔細檢查要刪除的受眾群體。

    ❗️警告:請勿刪除所有用戶。執行這些步驟時要非常小心,確保不要刪除所有用戶。

刪除用戶API說明

該接口用於刪除現有用戶(registration_id),這將刪除其所有相關數據和綁定標籤別名,以及設備信息和時區信息。此刪除操作是異步執行的。

調用地址

DELETE /v4/devices/{registration_id}
          DELETE /v4/devices/{registration_id}

        
此代碼塊在浮窗中顯示

請求報頭

DELETE /v4/devices/{registration_id} Authorization: Basic (base64 auth string) Accept: application/json
          DELETE /v4/devices/{registration_id}
Authorization: Basic (base64 auth string)
Accept: application/json

        
此代碼塊在浮窗中顯示

請求參數

名稱 是否必選 說明
Registration ID 設備在engagelab系統的唯一標識,不支持批量刪除

請求示例

DELETE /v4/devices/abc123 Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l Accept: application/json
          DELETE /v4/devices/abc123
Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
Accept: application/json

        
此代碼塊在浮窗中顯示

返回示例

成功返回

HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "success": true }
          HTTP/1.1 200 OK 
Content-Type: application/json; charset=utf-8
{
  "success": true
}

        
此代碼塊在浮窗中顯示

失敗返回

{ "error":{ "code":27002, "message":"unknown error" } }
          {
  "error":{
    "code":27002, 
    "message":"unknown error"
    }
}

        
此代碼塊在浮窗中顯示
在文档中心打开
icon
Contact Sales