Batch Remove Chatroom Attributes (KV)
Batch delete custom attribute KV pairs in a specified chatroom, with a maximum of 20 KV pairs per request. This interface forces the deletion of KV pairs and does not require the user ID of the KV pair owner. Users with administrator roles in the application can use this interface to clear business data in a specified chatroom.
Request Method
POST: https://data center domain/chatroom/entry/batch/remove.json
Rate Limit: 100 requests per second
Signature Rule: All server API requests must be validated according to the rules. For details, see API Request Signature.
Request Parameters
The HTTP request body is in application/x-www-form-urlencoded format and supports the following HTTP form parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| chatroomId | String | Yes | Chatroom ID |
| entryOwnerId | String | Yes | User ID of the attribute owner. |
| entryKeys | Array | Yes | Set of keys to be deleted. |
Request Example
POST /chatroom/entry/batch/remove.json HTTP/1.1
Host: api-cn.ronghub.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded
X-Request-ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXX(Max length 36)
chatroomId=gid1entryOwnerId=test&entryKeys=["key1","key2"]
Response
The HTTP response body contains a JSON object with the following structure:
| Return Value | Return Type | Description |
|---|---|---|
| code | Int | Return code. 200 indicates success. |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXX
{"code":200}