KeyHub 客户端 API 文档

本文档详细介绍了如何集成 KeyHub 授权验证接口。

验证接口 (Verify API)

用于验证客户端授权 Key 并绑定当前机器。

参数名	类型	必填	说明
`key`	String	是	授权密钥 (格式: `KH-XXXXXXXX-XXXXXXXX`)
`machine_id`	String	是	机器硬件指纹/唯一标识符(客户端生成)

JSON

{
    "key": "KH-A1B2C3D4-E5F6G7H8",
    "machine_id": "CPU-8888-9999-UUID"
}

返回 JSON 格式数据：

字段名	类型	说明
`valid`	Boolean	验证是否通过 (`true` 表示授权有效，`false` 表示授权无效)
`message`	String	提示信息 (中文)

状态码: 200 OK

JSON

{
    "valid": true,
    "message": "验证通过 (新绑定已创建)"
}

状态码: 200 OK

JSON

{
    "valid": true,
    "message": "验证通过 (已绑定)"
}

状态码: 404 Not Found

JSON

{
    "valid": false,
    "message": "未找到密钥"
}

状态码: 403 Forbidden

JSON

{
    "valid": false,
    "message": "密钥已禁用"
}