Refresh Group Information
Synchronize the group name with the IM server to ensure consistency between the group name in your application and the IM server.
When the group name changes, call this API to refresh the group name information stored on the IM server, ensuring that the correct group name is displayed in remote push notifications (PUSH).
The refresh group information API only updates the group name carried in remote push notifications (PUSH).
The refreshed group information takes effect within 5 minutes, and the updated group name will be displayed in push notifications after it takes effect.
Request Method
POST: https://data center domain/group/refresh.json
Rate Limit: 100 requests per second
Signature Rule: All server API requests must be validated according to the signature rules. For details, see API Request Signature.
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 |
|---|---|---|---|
| groupId | String | Yes | Group ID. |
| groupName | String | Yes | Group name. |
Request Example
POST /group/refresh.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
groupId=123&groupName=new
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
{"code":200}