创建角色

创建一个新的自定义角色。

请求地址：/openapi/v1/role/create

请求方法：POST

请求参数

参数	类型	是否必填	说明	示例
name	String	是	角色名称。建议在当前组织内保持唯一，便于后续查询和维护。	Dev-Test

如何使用返回值

调用成功后，响应中的 data.roleId 就是后续角色接口要使用的 roleId。例如，可以直接将该值用于 修改角色名称、修改角色模块权限、添加角色成员 和 删除角色。

请求示例

{
  "name": "Dev-Test"
}

返回参数

参数	类型	说明	示例
success	Boolean	请求是否成功。	true
requestId	String	请求 ID。	Bb4b8JMW-JPPPdTOnMLKb0RGdMKs2QXO
data	Object	新创建的角色信息，包含 roleId 字段。	{ "roleId": "2394" }

调用成功示例

{
  "success": true,
  "requestId": "Bb4b8JMW-JPPPdTOnMLKb0RGdMKs2QXO",
  "data": {
    "roleId": "2394"
  }
}