更新用户标签

为用户添加或删除标签。foreignId 和 phone 至少填一个；tag_ids 为标签 ID 数组；type 取值：save（添加）、delete（删除）、replace（替换）。需要企业开通客户标签服务。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和

请求体

名称	类型	必填	描述	示例值
foreignId	string	否	用户唯一标识（foreignId），与 phone 二选一	user_12345
phone	string	否	用户手机号，与 foreignId 二选一	13800138000
tag_ids	int64[]	是	标签 ID 数组	[1001,1002]
type	string	是	操作类型：save-添加，delete-删除，replace-替换	save

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	提示信息
result	int64[]	操作成功的标签 ID 列表	[1001,1002]

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体 JSON 格式错误；foreignId/phone 均为空或超长；tag_ids 为空或格式非法；eventType 非法
14500	服务内部异常
14515	企业未开通客户标签服务

postEndpoint

/openapi/tag/update

curl -X POST "https://qiyukf.com/openapi/tag/update?appKey=string&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef" \  -H "Content-Type: application/json" \  -d '{    "tag_ids": [      1001,      1002    ],    "type": "save"  }'

{
  "code": 200,
  "message": "string",
  "result": [
    1001,
    1002
  ]
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体 JSON 格式错误；foreignId/phone 均为空或超长；tag_ids 为空或格式非法；eventType 非法"
}

{
  "code": 14500,
  "message": "服务内部异常"
}

{
  "code": 14515,
  "message": "企业未开通客户标签服务"
}