# 添加

## **角色-添加**

* 接口名称：添加角色
* 请求方式：post
* 请求示例：[/rbac/roles](https://github.com/windhoney/yii2-rest-rbac/tree/5607a3fc72fd54f761435b601794fd2091885740/%7B%7Bbook.api_url%7D%7D/rbac/roles/README.md)
* 请求参数说明：

| 元素名称        | 数据类型   | 是否非空 | 元素说明 | 备注  |
| ----------- | ------ | ---- | ---- | --- |
| name        | string | 是    | 名称   | --- |
| description | string | 是    | 描述   | --- |
| ruleName    | string | 否    | 规则名称 | --- |
| data        | string | 否    | 数据   | --- |

## **添加示例：**

* 数据格式：数组&#x20;

```php
{
    "name": "超级管理员",
    "description": "这是超级管理员",
    "ruleName": "",
    "data": ""
}
```

## **返回信息：**

* 数据格式：JSON
* 成功示例：

添加成功返回权限列表

```php
{
    "code": 200,
    "message": "OK",
    "data": {
        "type": 1,
        "name": "超级超级管理员",
        "description": "角色1234",
        "ruleName": null,
        "data": null,
        "createdAt": 1499917897,
        "updatedAt": 1499917897
    }
}
```

* 失败示例：

  ```php
  { 
    "code": 400, 
    "message": "操作失败",
  }
  ```
