Query Chatroom Basic Information (Deprecated)
tip
This API is deprecated. Please use the new API Get Chatroom Basic Information.
Query the basic information of a chatroom, including: chatroom ID, name, and creation time.
Request Method
POST https://Data Center Domain/chatroom/query.json
Rate Limit: 100 requests per second
Signature Rule: All server-side API requests require signature verification. For details, see 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 chatroom ID to query. A single request can query up to 20 chatrooms. |
Request Example
POST /chatroom/query.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Timestamp: 1408710653491
Nonce: 14314
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded
chatroomId=10001&chatroomId=10002
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. |
| chatRooms | Array of objects | Array of chatroom information. |
| chatRooms[].chrmId | String | Chatroom ID. |
| chatRooms[].name | String | Chatroom name. |
| chatRooms[].time | String | Chatroom creation time. Accurate to the second, in the format YYYY-MM-DD HH:MM:SS, e.g., 2022-09-25 16:12:38. Note: The value of time is related to the data center of the app. If your app uses the China (Beijing) Data Center, time is in Beijing time. If your app uses the global data center, time is in UTC time. |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"code":200,
"chatRooms":[{
"chrmId":"10001","name":"name1","time":"2014-01-01 1:1:1"
},
{
"chrmId":"10002","name":"name2","time":"2014-01-01 1:1:2"
}]
}