Register Machine Information

Bind machine information to a specified user for ASAC core check unit machine authentication.

Endpoint: POST /machine/register/register_machine_info

---

Request Headers

Parameter	Required	Description
Content-Type	Yes	Fixed value: application/json

---

Request Parameters

Parameter	Type	Required	Format	Description
user_id	string	Yes	18-character string	User ID number
machine_code	string	Yes	32-character string	Machine code
windows_uuid	string	Yes	-	Machine Windows system UUID
windows_product_id	string	Yes	-	Machine Windows system product ID
machine_os_name	string	Yes	-	Machine operating system name
machine_os_version	string	Yes	-	Machine operating system version
machine_architecture	string	Yes	-	Machine architecture (e.g., x64)
machine_architecture_type	string	Yes	-	Machine architecture type
machine_platform	string	Yes	-	Machine operating system platform
machine_cpu	string	Yes	-	Machine CPU model
machine_motherboard	string	Yes	-	Machine motherboard model
machine_mac_address	string	Yes	-	Machine MAC address

---

Request Example

{
    "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"
}

---

Response Parameters

Parameter	Type	Required	Description
status	int	Yes	HTTP status code
code	string	Yes	Registration result code
result	string	Yes	Registration result
data	dict	Yes	Registration result data

---

data Parameters

Parameter	Type	Required	Description
machine_code	string	Yes	Machine code
user_id	string	Yes	User ID number (redacted)

---

Success Response Example

{
    "status": 200,
    "code": "10000",
    "result": "Machine registered successfully",
    "data": {
        "machine_code": "abcd1234efgh5678ijkl9012mnop3456",
        "user_id": "110***********1234"
    }
}

---

Error Response Examples

Endpoint Not Open

{
    "status": 403,
    "code": "10001",
    "result": "Server has not opened this endpoint",
    "data": {}
}

Invalid User ID Format

{
    "status": 400,
    "code": "10002",
    "result": "Invalid user ID format",
    "data": {}
}

Machine Code Already Registered

{
    "status": 409,
    "code": "10004",
    "result": "Machine code already registered",
    "data": {}
}

Registration Failed, Server Internal Error

{
    "status": 500,
    "code": "10005",
    "result": "Registration failed, server internal error",
    "data": {}
}

---

Error Code Description

Code	Description
10000	Machine registered successfully
10001	Server has not opened this endpoint / Invalid user ID format
10002	Invalid user ID format / Server has not opened this endpoint
10003	User does not exist / Failed to get machine information, server internal error
10004	Machine code already registered
10005	Registration failed, server internal error

---

Warning

Each machine code can only be bound to one user account. Once bound, it cannot be transferred to another account.

Tip

It is recommended to verify if the machine code is available before binding using the /verify/verify_is_machine_code_available endpoint.

---

← Back to API Documentation | ← Check if Machine Code is Available | → Get User Machine Information