对外接入说明

API 文档

给插件、桌面端与测试同学直接查阅:正式接口、授权模型、多语言示例与联调路径。

POST推荐正式接口
路径/api/license/activate
完整http://127.0.0.1:3000/api/license/activate

激活接口

在用户输入激活码时绑定设备,建立正式授权关系。

适用时机: 首次录入激活码,或客户端重新验证当前设备是否仍可继续使用时。

请求示例
可直接用于 Postman、脚本或插件侧联调。
{
  "projectKey": "browser-plugin",
  "code": "A1B2C3D4E5F6G7H8",
  "machineId": "machine-001"
}
  • 时间型会在首次激活时开始计算有效期。
  • 次数型只绑定设备,不扣减 remainingCount。
  • 支持 camelCase 与 snake_case 混合请求字段。
响应示例
用于核对业务是否成功、字段是否匹配以及是否命中幂等。
{
  "success": true,
  "message": "激活码激活成功",
  "licenseMode": "COUNT",
  "license_mode": "COUNT",
  "expiresAt": null,
  "expires_at": null,
  "remainingCount": 2,
  "remaining_count": 2,
  "isActivated": true,
  "is_activated": true,
  "valid": true,
  "idempotent": null
}