Register Machine Information by AegisSpeed ID

Bind machine information to a specified user identified by AegisSpeed ID for ASAC core check unit machine authentication.

Endpoint: POST /machine/register/register_machine_info_by_aegisspeed_id

---

Request Headers

Parameter	Required	Description
Content-Type	Yes	Fixed value: application/json
Authorization	Yes	Bearer <token> obtained after user login

---

Request Parameters

Parameter	Type	Required	Format	Description
user_AegisSpeed_id	string	Yes	9-character string	User AegisSpeed ID
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_AegisSpeed_id": "ASD000001",
    "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 AegisSpeed ID

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

User AegisSpeed ID Does Not Match Token User

{
    "status": 403,
    "code": "10006",
    "result": "User AegisSpeed ID does not match",
    "data": {}
}

User Does Not Exist

{
    "status": 404,
    "code": "10003",
    "result": "User does not exist",
    "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
10002	Invalid user AegisSpeed ID
10003	User does not exist
10004	Machine code already registered
10005	Registration failed, server internal error
10006	User AegisSpeed ID does not match token user

---

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_by_aegisspeed_id endpoint.

---

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