标签: Party.Group

Group: Remove Member

移除一名群组的成员。只有群主可以执行该操作,也只有群主收到该名成员被移除的消息。如果群主想要将已移除的成员恢复到群组,执行Party.Group.addMember API 来实现。

注意:移除群成员后导致群组有效成员少于3人,在24小时内,若该群组依然少于3人则触发系统强制解散操作,并且群主不可恢复该群组。

Request

HTTP request

POST https://www.featapi.com/api/party/group/{id}/remove_member/

Parameters

Path parameters

Parameter nameValueDescription
idstring群组 ID

Authorization

该请求需要授权以下scopes访问权限:

Scopes
party_group

For more information, see the authentication and authorization page.

Request body

In the request body, supply a Party.Contact resource with the following properties:

Property nameValueDescriptionNotes
必填
uidstring群组成员的用户ID,指定群组一名将要移除的成员。 范例:{“uid”: “5315959601855”}

Response

如果请求成功,返回被移除的群成员数据在响应体信息,并且该成员的“is_removed”字段为true。

200 Remove member from group successfully.

{
    "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
}

404 Not found

示例返回数据可参考 API Common – Resource Not Found