创建角色
POST
/api/v1/role
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Body 参数application/json必填
示例
{
"admin": true,
"createBy": 0,
"dataScope": "string",
"deptIds": [
0
],
"flag": "string",
"menuIds": [
0
],
"remark": "string",
"roleId": 0,
"roleKey": "string",
"roleName": "string",
"roleSort": 0,
"status": "string",
"sysDept": [
{
"children": [
{}
],
"createBy": 0,
"createdAt": "string",
"dataScope": "string",
"deptId": 0,
"deptName": "string",
"deptPath": "string",
"email": "string",
"leader": "string",
"params": "string",
"parentId": 0,
"phone": "string",
"sort": 0,
"status": 0,
"updateBy": 0,
"updatedAt": "string"
}
],
"sysMenu": [
{
"action": "string",
"apis": [
0
],
"breadcrumb": "string",
"children": [
{}
],
"component": "string",
"createBy": 0,
"createdAt": "string",
"dataScope": "string",
"icon": "string",
"isFrame": "string",
"is_select": true,
"menuId": 0,
"menuName": "string",
"menuType": "string",
"noCache": true,
"params": "string",
"parentId": 0,
"path": "string",
"paths": "string",
"permission": "string",
"roleId": 0,
"sort": 0,
"sysApi": [
{
"action": "string",
"createBy": 0,
"createdAt": "string",
"handle": "string",
"id": 0,
"path": "string",
"title": "string",
"type": "string",
"updateBy": 0,
"updatedAt": "string"
}
],
"title": "string",
"updateBy": 0,
"updatedAt": "string",
"visible": "string"
}
],
"updateBy": 0
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://gin-user-center.jinxinapp.cn/api/v1/role' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"admin": true,
"createBy": 0,
"dataScope": "string",
"deptIds": [
0
],
"flag": "string",
"menuIds": [
0
],
"remark": "string",
"roleId": 0,
"roleKey": "string",
"roleName": "string",
"roleSort": 0,
"status": "string",
"sysDept": [
{
"children": [
{}
],
"createBy": 0,
"createdAt": "string",
"dataScope": "string",
"deptId": 0,
"deptName": "string",
"deptPath": "string",
"email": "string",
"leader": "string",
"params": "string",
"parentId": 0,
"phone": "string",
"sort": 0,
"status": 0,
"updateBy": 0,
"updatedAt": "string"
}
],
"sysMenu": [
{
"action": "string",
"apis": [
0
],
"breadcrumb": "string",
"children": [
{}
],
"component": "string",
"createBy": 0,
"createdAt": "string",
"dataScope": "string",
"icon": "string",
"isFrame": "string",
"is_select": true,
"menuId": 0,
"menuName": "string",
"menuType": "string",
"noCache": true,
"params": "string",
"parentId": 0,
"path": "string",
"paths": "string",
"permission": "string",
"roleId": 0,
"sort": 0,
"sysApi": [
{
"action": "string",
"createBy": 0,
"createdAt": "string",
"handle": "string",
"id": 0,
"path": "string",
"title": "string",
"type": "string",
"updateBy": 0,
"updatedAt": "string"
}
],
"title": "string",
"updateBy": 0,
"updatedAt": "string",
"visible": "string"
}
],
"updateBy": 0
}'返回响应
🟢200成功
*/*
Body
示例
{
"code": 0,
"msg": "string",
"requestId": "string",
"status": "string"
}修改于 2025-09-05 03:45:07