設置聯繫方式

最新更新:2025-03-18

聯繫方式可作為觸達對象用於通道觸達,如 App 通知、短信、郵件、WhatsApp等。當用戶的聯繫方式發生變更時,可使用本接口更新。

設置聯繫方式必須基於 EUID 進行設置。

調用地址

POST /v1/user/contact

調用驗證

EngageLab REST API 採用 HTTP 基本認證 的驗證方式:HTTP Header(頭)里加 Authorization:

Authorization: Basic ${base64_auth_string}
          Authorization: Basic ${base64_auth_string}

        
此代碼塊在浮窗中顯示

上述 base64_auth_string 的生成算法為:base64(api_key:api_secret)

  • Header 名稱是 "Authorization",值是 base64 轉換過的 "username:password" 對(中間有個冒號)。
  • 在 MA API 的場景里,username 是 APIKey,password 是 APISecret。請在數據來源中添加 API 類型的數據源獲得 APIKey 與 API Secret。

請求示例

請求頭

> POST /v1/user/contact > Content-Type: application/json > Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==
          > POST /v1/user/contact
> Content-Type: application/json
> Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==

        
此代碼塊在浮窗中顯示

請求體

{ "euid":10362473, "contacts":{ "mobile_phone": "18023456879", "email": "12@gmail.com" } }
          {
    "euid":10362473,
    "contacts":{
        "mobile_phone": "18023456879",
        "email": "12@gmail.com"
    }
}

        
此代碼塊在浮窗中顯示

請求參數

字段 類型 必填 描述
euid Long 用戶唯一ID
contacts JSON key是聯繫方式名稱,value是聯繫方式的值,都為string數據類型。
  • 目前支持的聯繫方式有email、mobile_phone、landline_phone、whatsapp_phone
  • 返回參數

    字段 類型 必填 描述
    code Int 接口調用是否成功,0表示成功或者部分成功,其他值代表失敗
    message String 接口調用結果描述,對返回碼的說明

    全部成功

    { "code": 0, "message": "success" }
              {
        "code": 0,
        "message": "success"
    }
    
            
    此代碼塊在浮窗中顯示

    全部失敗

    { "code": 0, "message": "success" }
              {
        "code": 0,
        "message": "success"
    }
    
            
    此代碼塊在浮窗中顯示

    錯誤碼

    錯誤碼 錯誤碼說明 解決措施
    40050 接口鑒權失敗 確認密鑰是否正確
    55014 聯繫方式已被設置 請檢查是否設置唯一性
    在文档中心打开
    icon
    聯繫銷售