拉黑群组。拉黑该群组之后，当前用户不再收到该群组的消息推送，该群组也不会再出现当前用户的Inbox会话区域。但是仍然可以在归档区域找到被拉黑的群组。
Request
HTTP request
POST https://www.featapi.com/api/party/group/{id}/black/
Parameters
Path parameters
| Parameter name | Value | Description |
|---|---|---|
| id | string | 群组 ID |
Authorization
该请求需要授权以下scopes访问权限:
| Scopes |
|---|
| party_group |
For more information, see the authentication and authorization page.
Request body
无需提交请求体信息。
Response
如果请求成功，该API返回被拉黑的群组的数据在响应体信息。
200 Black a group successfully.
{
"data": {
"id": 7740,
"group": {
"id": 6999,
"name": "拉黑这个群组",
"creator": 9716362343737,
"creator_fullname": "潘 丽达",
"create_time": "2020-04-03T02:42:40.706327Z",
"status": 0,
"is_valid": true,
"bundle_id": null
},
"friend": null,
"friend_fullname": null,
"friend_first_name": null,
"friend_last_name": null,
"unread_count": 0,
"status": 600,
"contact_time": "2020-04-03T05:08:13.960422Z",
"expertise": null,
"timezone": null,
"timezone_utc_offset": null,
"location": null,
"avatar": null
}
}400 非法操作
PARTY_GROUP_BLACK_ERROR —— 群主不可以拉黑自己的群组
{
"error": true,
"message": "Not allow, group creator cannot black his/her group.",
"data": {},
"code": "PARTY_GROUP_BLACK_ERROR"
}404 Not found
示例返回数据可参考 API Common – Resource Not Found