用户视图集API：移除用户从用户组

API名称：移除用户从用户组

API描述：该API用于将指定用户从指定用户组中移除。

API方法：DELETE

API路径：/users/{userId}/groups/{groupId}

请求参数：

- userId：要移除的用户的ID（必选）

- groupId：要移除的用户组的ID（必选）

请求示例：DELETE /users/123/groups/456

查询示例：GET /users/123/groups

返回结果：

- 成功：返回204 No Content

- 失败：返回适当的错误状态码和错误信息

使用场景：

1. 管理员需要将某个用户从某个用户组中移除，例如该用户已经不再属于该组。

2. 用户希望退出某个群组。

示例代码（使用Python的requests库）：

import requests

# 调用API移除用户从用户组
def remove_user_from_group(user_id, group_id):
    url = f"https://api.example.com/users/{user_id}/groups/{group_id}"
    headers = {"Authorization": "Bearer your_access_token"}
    response = requests.delete(url, headers=headers)

    if response.status_code == 204:
        print("User removed from group successfully")
    else:
        print(f"Failed to remove user from group. Error: {response.text}")

# 调用示例
remove_user_from_group(123, 456)

以上示例代码使用了Python的requests库发送了一个DELETE请求，删除了用户ID为123的用户从用户组ID为456的用户组中。

请确保替换示例代码中的URL、Authorization以及用户ID和用户组ID为正确的值。

返回结果中的status_code为204表示操作成功。

注意事项：

- 调用该API需要提供合法的访问令牌（access token），以确保权限验证通过。

- 调用者必须具有操作用户组的权限，才能调用该API。

- 被移除的用户将不再属于该用户组，但仍然保留个人账号。

- 移除操作一旦完成，无法通过API撤销。如需重新添加用户到用户组，需要重新调用相应的API。

- 为了保证系统的安全性， 限制对该API的调用权限，只允许特定的管理员或有权限的用户使用。

- 在调用该API之前，建议先使用getUserGroups API验证用户是否属于该组。