激活码授权业务文档

适用于软件、插件、工具或虚幻引擎插件的激活码校验。后台创建激活码，客户端只负责验证激活码是否仍然有效。

项目要求

后台创建项目时，项目类型选择 激活码授权管理
后台生成或录入激活码，客户端调用验证接口
后台可随时禁用、启用或删除激活码

客户端接口

POST /api/verify

验证激活码是否属于指定项目且处于启用状态。

请求示例

验证激活码

{
    "key": "KH-A1B2C3D4-E5F6G7H8",     // 必填：后台生成或录入的激活码
    "project_name": "Unreal Plugin Project" // 必填：激活码授权项目名称
}

验证成功响应

{
    "valid": true,                    // 客户端主要判断字段：true 表示激活码有效
    "message": "验证通过",            // 验证结果说明
    "id": 6,                          // 授权记录ID
    "key": "KH-A1B2C3D4-E5F6G7H8",    // 当前激活码
    "project_id": 4,                  // 项目ID
    "project_name": "Unreal Plugin Project", // 项目名称
    "project_type": "activation",    // 项目类型：激活码授权管理
    "is_active": true,                // 后台是否启用
    "auth_type": "unlimited",        // 激活码默认不限次数/日期
    "remaining_plays": null,          // 播控项目才使用
    "valid_until": null,              // 播控项目才使用
    "machine_code": null,             // 播控项目才使用
    "last_play_started_at": null,     // 播控项目才使用
    "playable": true,                 // 综合授权状态
    "expired": false                  // 是否过期
}

验证失败响应

{
    "valid": false,                   // false 表示激活码不可用
    "message": "授权已禁用"           // 失败原因，可展示或记录
}

接入说明

激活码项目不管理播放次数和到期时间，适合简单启用/禁用授权。
项目名称必须与后台项目名称完全一致。
如需要次数和到期时间，请使用 播控管理 项目类型。