Path: API › 系统管理

`POST /system`

获取系统统计信息，包含内存、CPU、运行时间、系统版本等综合数据。

## Request body

_Required._

- `action347.request_time` (string, required) — Unix 时间戳。
- `action347.request_token` (string, required) — 按 API 概览生成的签名。
- `action347.action` (string, required) — 具体操作名称。
  - one of `"GetSystemTotal"`

## Example request

```text
{
  "request_time": "string",
  "request_token": "string",
  "action": "GetSystemTotal"
}
```

## Code samples

### cURL（填写面板地址与签名）

```curl
curl --request POST \
  --url "https://your-panel.example.com:8888/system" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>" \
  --data-urlencode "action=GetSystemTotal"
```

## Responses

### default

接口响应，业务状态见下方详细说明。

#### Example

```json
{
  "memTotal": 3901,
  "memFree": 2918,
  "memBuffers": 22,
  "memCached": 338,
  "memAvailable": 3056,
  "memRealUsed": 623,
  "cpuNum": 2,
  "cpuRealUsed": 12.5,
  "time": "0分钟",
  "system": "Debian GNU/Linux 13 x86_64(Py3.7.16)",
  "isuser": 1,
  "isport": false,
  "version": "11.7.0"
}
```

- `action347.response.default.memTotal` (integer, optional) — 总内存（MB）
- `action347.response.default.memFree` (integer, optional) — 空闲内存（MB）
- `action347.response.default.memBuffers` (integer, optional) — 缓冲区内存（MB）
- `action347.response.default.memCached` (integer, optional) — 缓存内存（MB）
- `action347.response.default.memAvailable` (integer, optional) — 可用内存（MB）
- `action347.response.default.memRealUsed` (integer, optional) — 实际已用内存（MB），不含 buffer/cache
- `action347.response.default.cpuNum` (integer, optional) — CPU 逻辑核心数
- `action347.response.default.cpuRealUsed` (number, optional) — CPU 实时使用率（%）
- `action347.response.default.time` (string, optional) — 系统已运行时间，如 `10天`、`5小时`、`30分钟`
- `action347.response.default.system` (string, optional) — 操作系统版本，如 `Debian GNU/Linux 13 x86_64(Py3.7.16)`
- `action347.response.default.isuser` (integer, optional) — 是否存在 admin 用户，`1` 为存在
- `action347.response.default.isport` (boolean, optional) — 面板端口是否为默认 8888
- `action347.response.default.version` (string, optional) — 面板版本号，如 `11.7.0`


## GetSystemTotal

获取系统统计信息，包含内存、CPU、运行时间、系统版本等综合数据。

- **路由**：`POST /system`
- **action**：`GetSystemTotal`

## 输入参数

除公共参数外无需额外参数。

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| action | 是 | String | 固定值 `GetSystemTotal` |

## 输出参数

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| memTotal | Integer | 总内存（MB） |
| memFree | Integer | 空闲内存（MB） |
| memBuffers | Integer | 缓冲区内存（MB） |
| memCached | Integer | 缓存内存（MB） |
| memAvailable | Integer | 可用内存（MB） |
| memRealUsed | Integer | 实际已用内存（MB），不含 buffer/cache |
| cpuNum | Integer | CPU 逻辑核心数 |
| cpuRealUsed | Float | CPU 实时使用率（%） |
| time | String | 系统已运行时间，如 `10天`、`5小时`、`30分钟` |
| system | String | 操作系统版本，如 `Debian GNU/Linux 13 x86_64(Py3.7.16)` |
| isuser | Integer | 是否存在 admin 用户，`1` 为存在 |
| isport | Boolean | 面板端口是否为默认 8888 |
| version | String | 面板版本号，如 `11.7.0` |

## 示例

### 请求

```
POST /system HTTP/1.1
Host: 192.168.168.213:8888
Content-Type: application/x-www-form-urlencoded

request_time=1700000000&request_token=xxx&action=GetSystemTotal
```

### 响应

```json
{
    "memTotal": 3901,
    "memFree": 2918,
    "memBuffers": 22,
    "memCached": 338,
    "memAvailable": 3056,
    "memRealUsed": 623,
    "cpuNum": 2,
    "cpuRealUsed": 12.5,
    "time": "0分钟",
    "system": "Debian GNU/Linux 13 x86_64(Py3.7.16)",
    "isuser": 1,
    "isport": false,
    "version": "11.7.0"
}
```