用户视图集API：创建用户组

**创建用户组API**

创建用户组API用于在系统中创建一个新的用户组。用户组是一组具有相同权限和角色的用户的集合。

**API请求**

POST /api/user_groups

**请求参数**

| 参数 | 类型 | 描述 |

| ----------- | ---- | ----------------- |

| name | string | 用户组名称 |

| description | string | 用户组描述 |

**示例请求**

POST /api/user_groups
Content-Type: application/json

{
  "name": "Admin Group",
  "description": "User group with administrative privileges"
}

**API响应**

| 参数 | 类型 | 描述 |

| ----------- | ---- | ----------------- |

| id | int | 用户组ID |

| name | string | 用户组名称 |

| description | string | 用户组描述 |

| created_at | string | 用户组创建时间 |

**示例响应**

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": 1,
  "name": "Admin Group",
  "description": "User group with administrative privileges",
  "created_at": "2021-01-01T12:00:00Z"
}

**使用例子**

在一个用户管理系统中，管理员可以通过创建用户组API来创建具有特定权限和角色的用户组。例如，管理员可以创建一个名为"Admin Group"的用户组，该用户组可以具有管理用户、编辑权限和访问所有资源的角色。

管理员通过发送以下请求来创建用户组：

import requests

url = "http://example.com/api/user_groups"
headers = {
  'Content-Type': 'application/json'
}

data = {
  "name": "Admin Group",
  "description": "User group with administrative privileges"
}

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
    user_group = response.json()
    print("User group created successfully!")
    print("User group ID:", user_group["id"])
else:
    print("Failed to create user group. Error:", response.text)

在上述示例中，管理员通过向API发送POST请求来创建用户组。请求的内容包括用户组的名称和描述。如果请求成功，API将返回创建的用户组的详细信息，包括用户组的ID、名称、描述和创建时间。

管理员可以根据系统需求创建多个不同的用户组，并根据需要将用户分配到相应的用户组中。这样可以方便地管理和控制用户的权限和角色。