跳到主要内容

根据 OpenID 增加用户标签

TagUserByOpenID：根据 OpenID 增加用户标签。需在 SmartLink > 联系人 > 标签管理 先创建好标签。

POST /api/v3/userinfo/tag_user_by_openid

请求参数​

了解关于查询参数的更多信息，请参见 查询参数。

属性数据类型备注描述
openidstring必填唯一用户 ID（最多20个数字字符）
modify_tsbigint必填最后更新时间戳（以毫秒为单位）
tags[]string必填自定义标签，对用户进行分组，用于用户分层：
  • 需在 SmartLink > 联系人 > 标签管理 先创建好标签，若导入不存在的标签则会更新失败。
  • 标签只能增加，不会覆盖原来数据。
  • 每个用户最多可关联100个标签。

请求示例​

curl --request POST "https://openapi.smartlink.intlgame.com/api/v3/userinfo/tag_user_by_openid?gameid=${GAME_ID}&seq=${YOUR_RANDOM_STRING}&sig=${SIGNATURE}&ts=${TS}" \
--header 'Content-Type: application/json' \
--data-raw '{
    "openid": "1012156612344364",
    "modify_ts": 1691225447577,
    "tags": [
        "tag1",
        "tag2"
    ]
}'

响应参数​

属性数据类型描述
codeint返回码
msgstring返回消息

响应示例​

{
  "code": 0,
  "msg": "Success",
  "seq": "{YOUR_RANDOM_STRING}"
}