Transfer Group Ownership
Transfer group management privileges to another member, with the option to leave the group.
Enabling the Service
Before using this feature, you must enable the profile hosting service by submitting a ticket.
Request Method
POST: https://data center domain/entrust/group/transfer/owner.json
Rate Limit: 100 requests per second
Signature Rule: All server API requests require signature verification. See API Request Signature for details.
Request Parameters
The HTTP request body uses application/x-www-form-urlencoded
format and supports the following form parameters:
Parameter | Type | Required | Description |
---|---|---|---|
groupId | String | Yes | Group ID |
newOwner | String | Yes | ID of the new Group Owner |
isQuit | Number | No | Whether the original Group Owner leaves the group:
|
isDelBan | Number | No | Whether to remove the original Group Owner's mute status (applies when isQuit=1):
|
isDelWhite | Number | No | Whether to remove the original Group Owner from the Mute Exceptions list (applies when isQuit=1):
|
isDelFollowed | Number | No | Whether to remove the original Group Owner from Members I Follow (applies when isQuit=1):
|
Request Example
POST /entrust/group/transfer/owner.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=groupId1&newOwner=fff
Response
The HTTP response body contains a JSON object with the following structure:
Field | Type | Description |
---|---|---|
code | Number | Status code (200 indicates success). |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"code": 200
}