注册机器信息

将机器信息绑定到指定用户，用于 ASAC 核心检查单元的机器认证。

接口地址：POST /machine/register/register_machine_info

---

请求头

参数名	必填	说明
Content-Type	是	固定值：application/json

---

请求参数

参数名	类型	必填	格式	说明
user_id	string	是	18位字符串	用户身份证号
machine_code	string	是	32位字符串	机器码
windows_uuid	string	是	-	机器 Windows 系统 UUID
windows_product_id	string	是	-	机器 Windows 系统产品 ID
machine_os_name	string	是	-	机器操作系统名称
machine_os_version	string	是	-	机器操作系统版本
machine_architecture	string	是	-	机器架构（如 x64）
machine_architecture_type	string	是	-	机器架构类型
machine_platform	string	是	-	机器操作系统平台
machine_cpu	string	是	-	机器 CPU 型号
machine_motherboard	string	是	-	机器主板型号
machine_mac_address	string	是	-	机器 MAC 地址

---

请求示例

{
    "user_id": "110***********1234",
    "machine_code": "abcd1234efgh5678ijkl9012mnop3456",
    "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	int	是	HTTP 状态码
code	string	是	注册结果代码
result	string	是	注册结果
data	dict	是	注册结果数据

---

data 参数

参数名	类型	必填	说明
machine_code	string	是	机器码
user_id	string	是	用户身份证号（脱敏）

---

成功响应示例

{
    "status": 200,
    "code": "10000",
    "result": "绑定成功",
    "data": {
        "machine_code": "abcd1234efgh5678ijkl9012mnop3456",
        "user_id": "110***********1234"
    }
}

---

错误响应示例

接口未开放

{
    "status": 403,
    "code": "10001",
    "result": "服务器未开放此接口",
    "data": {}
}

用户身份证号不合法

{
    "status": 400,
    "code": "10002",
    "result": "用户身份证号不合法",
    "data": {}
}

用户不存在

{
    "status": 404,
    "code": "10003",
    "result": "用户不存在",
    "data": {}
}

机器码已被注册

{
    "status": 409,
    "code": "10004",
    "result": "机器码已被注册",
    "data": {}
}

绑定失败，服务器内部错误

{
    "status": 500,
    "code": "10005",
    "result": "绑定失败，服务器内部错误",
    "data": {}
}

---

错误代码说明

代码	说明
10001	服务器未开放此接口
10002	用户身份证号不合法
10003	用户不存在
10004	机器码已被注册
10005	绑定失败，服务器内部错误

---

提示

此接口用于将机器信息绑定到用户账号，每个用户可以绑定多台机器。

警告

建议在绑定前先调用 /verify/verify_is_machine_code_available 接口验证机器码是否已被占用。

---

← 返回 API 文档首页 | ← 验证机器码是否可用 | → 获取机器信息