获取用户机器信息
2026/2/23大约 2 分钟
获取用户机器信息
获取当前登录用户名下所有已绑定的机器信息。
接口地址:GET /machine/info/get_machines
请求头
| 参数名 | 必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定值:application/json |
| Authorization | 是 | Bearer token,用户认证令牌 |
请求参数
无
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | int | 是 | HTTP 状态码 |
| code | string | 是 | 查询结果代码 |
| result | string | 是 | 查询结果 |
| data | dict | 是 | 查询结果数据 |
data 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| machines | list | 是 | 机器信息列表 |
machines 列表项参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| machine_code | string | 是 | 机器码 |
| user_id | string | 是 | 用户身份证号 |
| windows_uuid | string | 是 | 机器 Windows 系统 UUID |
| windows_product_id | string | 是 | 机器 Windows 系统产品 ID |
| machine_os_name | string | 是 | 机器操作系统名称 |
| machine_os_version | string | 是 | 机器操作系统版本 |
| machine_architecture | string | 是 | 机器架构 |
| machine_architecture_type | string | 是 | 机器架构类型 |
| machine_platform | string | 是 | 机器操作系统平台 |
| machine_cpu | string | 是 | 机器 CPU 型号 |
| machine_motherboard | string | 是 | 机器主板型号 |
| machine_mac_address | string | 是 | 机器 MAC 地址 |
成功响应示例
{
"status": 200,
"code": "10000",
"result": "获取机器信息成功",
"data": {
"machines": [
{
"machine_code": "abcd1234efgh5678ijkl9012mnop3456",
"user_id": "110***********1234",
"windows_uuid": "12345678-1234-1234-1234-123456789012",
"windows_product_id": "12345-12345-12345-12345-12345",
"machine_os_name": "Microsoft Windows 11",
"machine_os_version": "10.0.22631",
"machine_architecture": "x64",
"machine_architecture_type": "AMD64",
"machine_platform": "Win32",
"machine_cpu": "12th Gen Intel(R) Core(TM) i7-12700K",
"machine_motherboard": "ASUS PRIME Z690-A",
"machine_mac_address": "00:11:22:33:44:55"
}
]
}
}错误响应示例
接口未开放
{
"status": 403,
"code": "10002",
"result": "服务器未开放此接口",
"data": {}
}token 已过期或无效
{
"status": 401,
"code": "10001",
"result": "token 已过期或无效",
"data": {}
}获取机器信息失败,服务器内部错误
{
"status": 500,
"code": "10003",
"result": "获取机器信息失败,服务器内部错误",
"data": {}
}错误代码说明
| 代码 | 说明 |
|---|---|
| 10000 | 获取机器信息成功 |
| 10001 | token 已过期或无效 |
| 10002 | 服务器未开放此接口 |
| 10003 | 获取机器信息失败,服务器内部错误 |
提示
此接口需要用户登录后才能访问,需要在请求头中携带有效的 Authorization token。