Set User Tags
Set tags for a single user. Note that user tags can only be used in the following features:
tip
- You need to pass the full set of user tags each time you set them. Each user can have up to 20 tags.
- Passing an empty array in the
tagsfield will clear all tags for the user.
Request Method
POST: https://data center domain/user/tag/set.json
Rate Limit: 100 requests per second
Signature Rule: All server API requests require signature validation. For details, see API Request Signature.
Body Parameters
The HTTP request body is in application/json format and contains a JSON object with the following structure:
| Parameter | Type | Required | Description |
|---|---|---|---|
| userId | String | Yes | User ID. |
| tags | String[] | Yes | User tags. A user can have up to 20 tags, and each tag cannot exceed 40 bytes. Tags should not contain special characters. You need to pass the full set of user tags each time you set them. Passing an empty array will clear all tags for the user. |
Request Example
POST /user/tag/set.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/json
{"userId":"31232","tags":["bj","male"]}
Response
The HTTP response body contains a JSON object with the following structure:
| Return Value | Type | Description |
|---|---|---|
| code | Number | Return code, 200 means success. |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"code":200}