新建

最大可创建256个组。

支持创建和更新组信息，如group_id不存在则创建组信息，如group_id存在则更新组信息.

请求路径

/v1/group

请求方式

POST

• 请求体: application/json

字段	类型	必填	字段释义
group_id	String	Y	由提交端设置的唯一标识,不可重复,长度上限128字节
name	String	Y	组名称，内容长度1~128字节，不可重复
type	Int	N	组类型，1:员工组, 2：访客组, 5: 黑名单组；默认：1
rule_id	String	N	绑定的通行规则id,若该字段不存在 则不绑定通行规则

请求示例:

创建一个name为员工组的通行组，其group_id设定为1，type为1(员工组),但不绑定策略，即rule_id为空。

/v1/group

{
  "name": "员工组",
  "type": 1,
  "group_id": "1",
  "rule_id": ""
}

返回示例

{
    "data": {
        "name": "员工组",
        "type": 1,
        "group_id": "1",
        "rule_id": "",
        "create_at": 1660284813955,
        "update_at": 1660284813955
    },
    "code": 200,
    "msg": "OK"
}