设置用户会话标签

为指定用户创建会话标签信息。标签是会话分组管理的基础，用户需要先创建标签才能为会话设置标签归属。

提示

• 每个用户最多可以创建 20 个会话标签。
• 每个标签下最多可以添加 1000 个会话。
• 标签 ID 在单个用户下必须唯一，长度不超过 20 个字符。
• 标签名称长度不超过 15 个字符。

请求方法

POST： https://数据中心域名/user/conversation/tag/set.json

频率限制： 每秒 100 次

签名规则： 所有服务端 API 请求均需要进行签名验证，详见 API 请求签名。

正文参数

HTTP 请求正文数据格式为 application/json，支持以下参数：

参数	类型	必传	说明
userId	String	是	会话所属的用户 ID。
tags	Object[]	是	标签列表。单次最多 20 个标签。
tags[].tagId	String	是	标签 ID, 标签唯一标识。长度不超过 10 个字符，单个用户下标签 ID 不能重复。
tags[].tagName	String	是	长度不超过 15 个字符。

请求示例

HTTP

POST /user/conversation/tag/set.json
Host: api.rong-api.com
App-Key: xxxxxx
Nonce: 14314
Timestamp: 111111111111
Signature: xxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
    "userId":"testUserId",
    "tags":[
        {
            "tagId":"tag1",
            "tagName":"标签1"
        },
        {
            "tagId":"tag2",
            "tagName":"标签2"
        }
    ]
}

返回结果

HTTP 响应正文包含具有以下结构的 JSON 对象：

返回值	返回类型	说明
code	Number	返回码。200 表示成功。详见服务端 API 状态码。

返回结果示例

HTTP

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}