重命名一个群组。只有群主有权操作,对他创建的群组重新命名。成功后,群组会收到新群组名称的消息。
Request
HTTP request
POST https://www.featapi.com/api/party/group/{id}/rename/
重命名一个群组。只有群主有权操作,对他创建的群组重新命名。成功后,群组会收到新群组名称的消息。
POST https://www.featapi.com/api/party/group/{id}/rename/
移除一名群组的成员。只有群主可以执行该操作,也只有群主收到该名成员被移除的消息。如果群主想要将已移除的成员恢复到群组,执行Party.Group.addMember API 来实现。
注意:移除群成员后导致群组有效成员少于3人,在24小时内,若该群组依然少于3人则触发系统强制解散操作,并且群主不可恢复该群组。
POST https://www.featapi.com/api/party/group/{id}/remove_member/
Parameter name | Value | Description |
---|---|---|
id | string | 群组 ID |
该请求需要授权以下scopes访问权限:
Scopes |
---|
party_group |
For more information, see the authentication and authorization page.
In the request body, supply a Party.Contact resource with the following properties:
Property name | Value | Description | Notes |
---|---|---|---|
必填 | |||
uid | string | 群组成员的用户ID,指定群组一名将要移除的成员。 范例:{“uid”: “5315959601855”} |
如果请求成功,返回被移除的群成员数据在响应体信息,并且该成员的“is_removed”字段为true。
{
"id": 7786,
"user": 5315959601855,
"fullname": "Garfield MJ",
"first_name": "Garfield",
"last_name": "MJ",
"status": 300,
"contact_time": "2020-06-10T10:33:25.496694Z",
"expertise": "游泳",
"timezone": "Asia/Shanghai",
"timezone_utc_offset": "+08:00",
"location": "CHN",
"avatar": "/media/5315959601855/avatar/blob",
"is_removed": true
}
示例返回数据可参考 API Common – Resource Not Found
添加用户加入群组。群组的所有成员都可以添加用户进群。无须对方同意。
被移除的成员亦通过该方法重新加入群组。
POST https://www.featapi.com/api/party/group/{id}/add_member/
获取当前登录用户的群组列表。群组列表包含你创建和你加入的群组。
GET https://www.featapi.com/api/party/group/