Set Chatroom Auto-Destruction Type

Set the auto-destruction type for a chatroom. Before setting, please ensure you understand the Chatroom Destruction Mechanism.

• If destroyType is set to Inactive Destruction, you can use the destroyTime parameter to specify the inactivity duration (in minutes) after which the chatroom should be automatically destroyed. The chatroom will be destroyed if it remains inactive (no users entering/exiting and no new messages) for the specified duration.
• If destroyType is set to Fixed Time Destruction (scheduled auto-destruction), you can use the destroyTime parameter to configure the survival time (in minutes). The survival time is always calculated from the moment the chatroom is created. Chatrooms with this destruction type can survive for a maximum of 10800 minutes (7 days).

tip

If a chatroom is set to Fixed Time Destruction, the server will still record the cumulative duration of its inactivity. If the chatroom has been inactive for a long time, changing the destruction type to Inactive Destruction may result in the chatroom being destroyed immediately.

Request Method

POST: https://Data Center Domain/chatroom/destroy/set.json

Rate Limit: 100 requests per second

Signature Rule: All server API requests must follow the signature rule. For details, refer to API Request Signature.

Body Parameters

The HTTP request body data format is application/x-www-form-urlencoded. The following HTTP form parameters are supported:

Parameter	Type	Required	Description
chatroomId	String	Yes	Chatroom ID
destroyType	int	No	Specifies the destruction method for the chatroom. 0: Default value, indicating Inactive Destruction. By default, all chatrooms are set to Inactive Destruction and will be destroyed after 60 minutes of inactivity. You can extend this time using destroyTime. 1: Fixed Time Destruction. When set to this type, the chatroom will be automatically destroyed 60 minutes after creation by default. You can configure a longer survival time using destroyTime.
destroyTime	int	No	Sets the destruction time for the chatroom. When destroyType=0, it indicates the duration of inactivity (in minutes) after which the chatroom should be automatically destroyed. When destroyType=1, it indicates the survival time (in minutes) after creation after which the chatroom should be automatically destroyed. The unit is minutes, with a minimum of 60 minutes and a maximum of 10080 minutes (7 days). If not set, the default is 60 minutes.

Request Example

POST /chatroom/destroy/set.json HTTP/1.1
Host: api.rong-api.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=gid1&destroyType=0&destroyTime=120

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}