产品与许可证 API
把下单后的签发工作接到你自己的服务器:先建立产品和策略,再为每位客户创建许可证。前两项通常只需配置一次。
先在控制台创建有写权限的 管理 API Key。以下示例使用 Authorization: Bearer YOUR_MANAGEMENT_API_KEY;这个 Key 保留在厂商服务器中。
上面是最小签发流程。查询、修改、归档、续期、设备、用量、离线授权和事件通知等完整接口见 管理 API Key 的“全部管理请求与响应”。
有效天数在签发许可证时填写。固定期限和试用为 1–36500 天,永久授权不填。策略不保存有效天数。
创建成功后保存哪些值?
产品响应的 data.id 用作 product_id;策略响应的 data.id 用作 policy_id。签发许可证后保存 data.id 和 data.key。
可在许可证列表中再次查看和复制完整授权码。请仅提供给对应客户。
尚未激活的限期许可证,expires_at 和 first_activated_at 都是 null。首次成功激活后才开始计时;换机不会重新获得有效天数。
后续管理
| 方法与路径(省略 /api/v1) | 用途与请求正文 |
|---|---|
GET /products | 查产品列表。响应 data.items 是记录数组,data.total 是总数。 |
GET /licenses/{id} | 查询许可证详情和首次激活、到期时间。 |
POST /licenses/{id}/renew | 续期,例如 {"days":30}。成功后沿用原许可证。 |
POST /licenses/{id}/revoke | 吊销,请求正文为 {}。 |
GET /products/{id}/public-keys | 查看产品公钥,公开可读。SDK 分发时固定受信公钥。 |
GET /activations | 查看设备绑定及运行会话。 |
列表分页使用 limit=25&offset=0,limit 最大为 100。其他接口的参数和结构见 OpenAPI 文件;不同授权方式的接入步骤见左侧对应主题。
已有浏览器登录会话时,如何调用?
使用浏览器 Cookie 的写请求需要 X-CSRF-Token。先 GET /api/v1/auth/csrf,再把 data.csrf_token 放进这个请求头。Bearer Key 请求不需要 CSRF。