获取EUID
最新更新:2025-03-18
EUID 为 EngageLab MA 平台的用户唯一ID,您可以使用下述 API 基于用户标识获取 EUID
调用地址
POST /v1/user/register
调用验证
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/register
> Content-Type: application/json
> Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==
> POST /v1/user/register
> Content-Type: application/json
> Authorization: Basic N2Q0MzFlNDJkZmE2YTZkNjkzYWMyZDA0OjVlOTg3YWM2ZDJlMDRkOTVhOWQ4ZjBkMQ==
此代码块在浮窗中显示
请求体
{
"identity_name":"user_id", //用户标识名称
"identity_values": [
"18012345678", //用户标识value值
"18012345679"
]
}
{
"identity_name":"user_id", //用户标识名称
"identity_values": [
"18012345678", //用户标识value值
"18012345679"
]
}
此代码块在浮窗中显示
请求参数
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
identity_name | String | 是 | 用户标识名称,支持传值 user_id、 anonymous_id、registration_id |
identity_values | list | 是 | 用户标识的值,最多支持 100 个值,每个值不能超过 256 个字符 |
返回参数
字段 | 类型 | 必填 | 描述 |
---|---|---|---|
code | Int | 是 | 接口调用是否成功,0表示成功或者部分成功,其他值代表失败 |
message | String | 是 | 接口调用结果描述,对返回码的说明 |
data | Array | 否 | 返回用户标识对应的 EUID 列表 |
identity_value | String | 是 | 用户标识的值 |
euid | Long | 是 | 对应 EngageLab MA 用户唯一ID |
error_code | Int | 是 | EUID 是否获取成功,0 代表成功,其他值代表失败 |
全部成功
{
"code": 0,
"message": "success",
"data": [
{
"identity_value": "18012345678", //用户标识value值
"euid": 10362473, //生成的EUID,获取失败时为 null 值
"error_code": 0 //对应的错误码,成功是为0,失败时不为空,例如 40006
},
{
"identity_value": "18012340000",
"euid": 10362474,
"error_code": 0
}
]
}
{
"code": 0,
"message": "success",
"data": [
{
"identity_value": "18012345678", //用户标识value值
"euid": 10362473, //生成的EUID,获取失败时为 null 值
"error_code": 0 //对应的错误码,成功是为0,失败时不为空,例如 40006
},
{
"identity_value": "18012340000",
"euid": 10362474,
"error_code": 0
}
]
}
此代码块在浮窗中显示
全部失败
{
"code": 55101,
"message": "Exceeded the limit of user identifiers"
}
{
"code": 55101,
"message": "Exceeded the limit of user identifiers"
}
此代码块在浮窗中显示
部分成功
{
"code": 0,
"message": "success",
"data": [
{
"identity_value": "18012345678", //用户标识value值
"euid": null, //失败为null值
"error_code": -1 //对应的错误码,成功是为0,失败时不为空
},
{
"identity_value": "18012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000080123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000",
"euid": null,
"error_code": 55105
}
]
}
{
"code": 0,
"message": "success",
"data": [
{
"identity_value": "18012345678", //用户标识value值
"euid": null, //失败为null值
"error_code": -1 //对应的错误码,成功是为0,失败时不为空
},
{
"identity_value": "18012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000080123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000180123400001801234000018012340000",
"euid": null,
"error_code": 55105
}
]
}
此代码块在浮窗中显示