設置用戶屬性

調用地址

POST /v1/user/property

調用驗證

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/property > Content-Type: application/json > Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==

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

此代碼塊在浮窗中顯示

請求體

{ "euid":10362473, "type": "set", "properties":{ "user_number_once":46.2, //用戶屬性名稱和屬性值 "user_string_once":"refef", "user_datetime_once": "2023-12-12 00:56:23" } }

          {
    "euid":10362473,
    "type": "set",
    "properties":{
        "user_number_once":46.2, //用戶屬性名稱和屬性值
        "user_string_once":"refef",
        "user_datetime_once": "2023-12-12 00:56:23"
    }
}

此代碼塊在浮窗中顯示

請求參數

字段	類型	必填	描述
euid	Long	是	EngageLab MA 用戶唯一ID
type	String	是	對屬性進行更新的操作類型
properties	JSON	是	用戶屬性列表，key 是屬性名，value 是屬性值

返回參數

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

全部成功

{ "code": 0, "message": "success" }

          {
    "code": 0,
    "message": "success"
}

此代碼塊在浮窗中顯示

全部失敗

{ "code": 55102, "message": "Invalid user attributes exist" }

          {
    "code": 55102,
    "message": "Invalid user attributes exist"
}

此代碼塊在浮窗中顯示

錯誤碼

錯誤碼	錯誤碼說明	解決措施
40050	接口鑒權失敗	確認密鑰是否正確
55004	業務參數不合法	請檢查 properties 字段是否正確
55102	存在無效的用戶屬性	確認屬性key是否合法
55103	用戶屬性值不能為空	確認請求體中用戶屬性的值是否為空