Chatroom Keepalive
When there is no activity in a chatroom for 1 hour and no one joins the chatroom, the IM service will automatically kick out all members and destroy the chatroom. The Chatroom Keepalive feature ensures that the chatroom is not automatically destroyed under these conditions and can only be destroyed by calling the API.
Enable the Service
Before using the Chatroom Keepalive feature, ensure that the service is enabled for the current App Key. Once enabled, you can set up to 5 chatrooms to keep alive. If you need more, please contact our sales team.
If the service is not enabled, the Server API will return error code 1009. Note that if the API request frequency exceeds the limit due to continuous requests without the service enabled, the Server API will return HTTP 429 Too Many Requests error (error code 1008).
Request Method
POST: https://Data Center Domain/chatroom/keepalive/add.json
Rate Limit: 100 requests per second
Signature Rule: All server API requests require signature validation. For details, refer to API Request Signature.
Request Body Parameters
The HTTP request body data format is application/x-www-form-urlencoded, and the following HTTP form parameters are supported:
| Parameter | Type | Required | Description |
|---|---|---|---|
| chatroomId | String | Yes | The ID of the chatroom. |
Request Example
POST /chatroom/keepalive/add.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
chatroomId=16
Response
The HTTP response body contains a JSON object with the following structure:
| Return Value | Type | Description |
|---|---|---|
| code | Number | The return code, 200 indicates success. |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"code":200}