跳转至

用户标签

添加标签

为应用中的用户添加标签,如果某用户已经添加了标签,再次对用户添加标签时将覆盖之前设置的标签内容。

方法名:/user/tag/set

签名方法:请参考 通用 API 接口签名规则

URL:https://api-cn.ronghub.com/user/tag/set.[format]

[format] 表示返回格式,可以为 jsonxml,注意不要带 [ ]。

HTTP 方法:POST

请注意:发送请求时 HTTP Request Header 中的 Content-Type 类型必须为 application/json

示例

HTTP 请求:

POST /user/tag/set.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/json

{"userId":"31232","tags":["bj","男"]}

表单参数

名称 类型 说明
userId String 用户 Id。(必传)
tags String[] 用户标签,一个用户最多添加 20 个标签,每个 tag 最大不能超过 40 个字节,标签中不能包含特殊字符。(必传)

返回值

名称 类型 说明
code int 返回码,200 为正常。

JSON 格式:

{"code":200}

XML 格式:

<xml><code>200</code></xml>

返回值请参考 API 方法返回值说明

批量添加标签

为应用中的用户批量添加标签,如果某用户已经添加了标签,再次对用户添加标签时将覆盖之前设置的标签内容。

方法名:/user/tag/batch/set

签名方法:请参考 通用 API 接口签名规则

URL:https://api-cn.ronghub.com/user/tag/batch/set.[format]

[format] 表示返回格式,可以为 jsonxml,注意不要带 [ ]。

HTTP 方法:POST

请注意:发送请求时 HTTP Request Header 中的 Content-Type 类型必须为 application/json

示例

HTTP 请求:

POST /user/tag/batch/set.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/json

{"userIds":["id1","id2"],"tags":["bj","男"]}

表单参数

名称 类型 说明
userIds String[] 用户 Id,一次最多支持 1000 个用户。(必传)
tags String[] 用户标签,一个用户最多添加 20 个标签,每个 tag 最大不能超过 40 个字节,标签中不能包含特殊字符。(必传)

返回值

名称 类型 说明
code int 返回码,200 为正常。

JSON 格式:

{"code":200}

XML 格式:

<xml><code>200</code></xml>

返回值请参考 API 方法返回值说明

获取用户标签

查询用户所有标签功能,支持批量查询每次最多查询 50 个用户。

方法名:/user/tags/get

签名方法:请参考 通用 API 接口签名规则

URL:https://api-cn.ronghub.com/user/tags/get.[format]

[format] 表示返回格式,可以为 jsonxml,注意不要带 [ ]。

HTTP 方法:POST

请注意:发送请求时 HTTP Request Header 中的 Content-Type 类型必须为 application/json

示例

HTTP 请求:

POST /user/tags/get.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/x-www-form-urlencoded

userIds=111&userIds=222

表单参数

名称 类型 说明
userIds String[] 用户 Id,一次最多支持 50 个用户。(必传)

返回值

名称 类型 说明
code int 返回码,200 为正常。
result String[] 用户所有的标签数组。

JSON 格式:

{
    "code": 200,
    "result": {
        "111": [],
        "222": [
            "帅哥","北京"
        ]
    }
}