管理员服务
管理员服务概述
管理员服务提供了一系列API，用于管理平台的各种资源，包括硬件设备、用户账户、订单和优惠券等。这些API需要管理员权限才能访问。
所有管理员服务接口都需要有效的访问令牌，并且调用者必须具有管理员权限。请在请求头中包含Bearer令牌。
通用接口
获取资源模式
获取指定资源类型的数据模式。请求参数
GET /admin/schema?type=user
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
检查资源指针
检查资源指针的有效性。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| type | string | 是 | 资源类型 |
| pointer | string | 是 | 资源指针 |
GET /admin/pointer?type=user&pointer=user_123
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
获取资源列表
获取指定类型的资源列表。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| type | string | 是 | 资源类型 |
| page | integer | 否 | 页码，默认1 |
| size | integer | 否 | 每页数量 |
GET /admin/list?type=user&page=1&size=10
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
错误码说明
错误码说明
| 错误码 | 说明 |
|---|
| 400 | 请求参数错误 |
| 401 | 未授权或令牌无效 |
| 403 | 权限不足（需要管理员权限） |
| 404 | 资源不存在 |
| 422 | 请求参数验证失败 |
| 500 | 服务器错误 |
管理员服务分类
管理员服务包含以下几类API：
- 硬件管理 - 管理硬件设备
- 用户管理 - 管理用户账户
- 订单管理 - 管理订单信息
- 优惠券管理 - 管理优惠券
