根据邮箱导入用户（V3）

SyncUserByEmail（V3）：根据邮箱导入联系人信息。如果该联系人已经存在，则更新该邮箱的用户信息。 （此API至2026年7月15号不再继续开发维护，建议使用V4版本的SyncUserByEmail

POST /api/v3/userinfo/sync_user_by_email

请求参数

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

属性	数据类型	备注	描述
email	string	必填	邮箱
modify_ts	bigint	必填	最后更新时间戳（以毫秒为单位）
tags	[]string	选填	自定义标签，对用户进行分组，用于用户分层： 需在 SmartLink > 联系人 > 标签管理 先创建好标签，若导入不存在的标签则会更新失败。 标签只能增加，不会覆盖原来数据。 每个用户最多可关联100个标签。
openid	string	选填	唯一用户 ID（最多20个数字字符）
subscribe	int	选填	用户订阅状态 1: 订阅，0: 取消订阅，-1: 未知
location	string	选填	三位国家编码，详见 国家或地区信息表 对应的 number_code 区域参数为未知或空值时，不会覆盖原来数据。
language	string	选填	语言编码，详见 语言信息表 对应的 language_code 语言参数为未知或空值时，不会覆盖原来数据。
attributes	object	选填	自定义用户属性。支持更新联系人的其他属性，例如性别、生日等。 用于用户分层，进而创建更个性化的活动： 需在 SmartLink > 所有联系人 > 字段设置 先创建好字段，若导入不存在的字段则会更新失败。 用户属性只能增加或更新，未更新的字段不会覆盖原来数据。 每用户自定义属性字段累计不超过50个。 attributes 类型与格式： Text 类型：格式为 { "key":"value" } － key：自定义属性名称 － value：string 类型，范围不超过1000个字符 Number 类型：格式为 { "key":"value" } － key：自定义属性名称 － value：string 类型，范围 -9223372036854775808 至 9223372036854775807 之间 Date 类型：格式为 { "key":"value" } － key：自定义属性名称 － value：string 类型，日期格式为 2001-03-31+08:00 或 2001-03-31 00:00:00+08:00 Drop down 类型：格式为 { "key":["value"] } － key：自定义属性名称 － value：[]string 类型，单个 string 不超过1000字符，如 ["选项1","选项2"]
preferences	[]string	选填	用于标识联系人的订阅偏好，能够按兴趣和偏好等对订阅者进行分类。 用于用户分层，将邮件定向发送给具有特定偏好的用户： 需在 SmartLink > 联系人 > 偏好 先创建好偏好选项，若导入不存在的偏好选项则会更新失败。 偏好只能增加，不会覆盖原来数据。 每个用户最多选择20个偏好选项。
update_strategy	int	选填	是否更新 subscribe 字段，详见 更新策略。

请求示例

curl --request POST "https://openapi.smartlink.intlgame.com/api/v3/userinfo/sync_user_by_email?gameid=${GAME_ID}&seq=${YOUR_RANDOM_STRING}&sig=${SIGNATURE}&ts=${TS}" \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "545058834@qq.com",
    "modify_ts": 1691225447577,
    "tags": [
        "tag1","tag2"
    ],
    "openid": "5450588341569",
    "subscribe": 1,
    "location": "004",
    "language": "en",
    "attributes": {
      "nickname": "tang",
      "level": "10",
      "birthday":"1990-05-09 00:00:00+08:00"
    },
    "preferences": [
      "option1","option2"
    ]
}'

更新策略

更新策略可用来控制是否使用传入的联系人信息来更新 subscribe 字段，通过在请求的 JSON 中添加 update_strategy 参数可以针对不同订阅状态的联系人改变更新策略。传入的 attributes 参数则不受更新策略影响，默认会用来更新联系人信息。

根据 update_strategy 所设置的值，不被更新的联系人的订阅状态（subscribe）将保持不变，即使接收到参数也不会进行更新。

update_strategy = 0 或不填：

系统内当前订阅状态	是否更新
已订阅	是
未订阅	是
未知	是
Pending	否

update_strategy = 1：

系统内当前订阅状态	是否更新
已订阅	是
未订阅	是
未知	是
Pending	是

update_strategy = 2：

系统内当前订阅状态	是否更新
已订阅	否
未订阅	否
未知	是
Pending	否

响应参数

属性	数据类型	描述
code	int	返回码
msg	string	返回消息

响应示例

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