# OpenAPI 接口 - 角色管理 - 简单列表查询

> 模块标识：openapi  |  接口数量：66

## 接口说明
**方法**：	GET

**路径**：				/openapi/roles/list/simple

**功能说明**：
无分页返回角色管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。

### 请求参数
```json
{
  "headers": [
    {
      "name": "X-Site",
      "type": "string",
      "required": true,
      "description": "站点标识（必填）"
    },
    {
      "name": "X-System-Code",
      "type": "string",
      "required": true,
      "description": "系统编码（必填）"
    }
  ],
  "query": [
    {
      "name": "name",
      "type": "string",
      "required": false,
      "description": "名称（模糊搜索）"
    },
    {
      "name": "code",
      "type": "string",
      "required": false,
      "description": "编码（模糊搜索）"
    },
    {
      "name": "sortBy",
      "type": "string",
      "required": false,
      "description": "排序字段，默认createTime"
    },
    {
      "name": "sortOrder",
      "type": "string",
      "required": false,
      "description": "排序方向：asc-升序，desc-降序，默认desc"
    }
  ]
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "查询成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "ROLE0001",
          "name": "管理员",
          "title": "系统管理员",
          "type": "system",
          "description": "系统管理员角色",
          "status": 1,
          "orderNum": 1,
          "permissions": [
            "PERM0001"
          ],
          "resources": [
            "RES0001"
          ],
          "createTime": "2025-01-01T10:00:00.000Z",
          "updateTime": "2025-01-01T10:00:00.000Z"
        }
      ]
    }
  }
}
```

### 注意事项
- 只返回状态为有效的记录（status=1）
- 最多返回100条数据
- 支持多种可选查询条件进行筛选
- 支持排序功能
- 必须提供有效的X-Site header，查询对应站点的数据
- 必须提供有效的X-System-Code header，支持客户端系统