Batch Set User Tags
Set tags for one or multiple specified users. Note that user tags are only applicable for the following features:
tip
- Full tag data must be passed in each time you set tags. The tag data for all users (
userIds) passed in will be overwritten. Each user can have up to 20 tags. - Passing an empty array in the
tagsfield will clear all tags for the specified users.
Request Method
POST: https://Data Center Domain/user/tag/batch/set.json
Rate Limit: 10 requests per second
Signature Rule: All server-side API requests must be signed. For details, refer to API Request Signature.
Request Body
The HTTP request body is in application/json format and contains a JSON object with the following structure:
| Parameter | Type | Required | Description |
|---|---|---|---|
| userIds | String[] | Yes | User IDs. Up to 1000 users can be processed in a single request. The tags for all users passed in will be overwritten with the tags specified in tags. |
| tags | String[] | Yes | User tags. Each user can have up to 20 tags, and each tag cannot exceed 40 bytes. Special characters are not allowed in tags. Full tag data must be passed in each time. Passing an empty array will clear all tags for the user. |
Request Example
POST /user/tag/batch/set.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/json
{"userIds":["id1","id2"],"tags":["bj","男"]}
Response
The HTTP response body contains a JSON object with the following structure:
| Return Value | Type | Description |
|---|---|---|
| code | Number | Return code. 200 indicates success. |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"code":200}