foren.dev

License API 参考

所有端点在 /license/api/coforen/ 下,详见 LICENSE_API.md。

快速目录

公共端点(无需鉴权)

  • GET /health/ — 健康检查
  • GET /public-key/ — Ed25519 公钥
  • POST /activate/ — 设备激活
  • POST /validate-offline/ — 离线 license 校验
  • POST /authorize/ — 产品授权校验
  • POST /authorize/token/ — 授权 token 校验
  • POST /certs/validate/ — 证书校验
  • GET /certs/crl/ — 证书吊销列表
  • GET /certs/download-key/?token=... — 私钥下载(一次性 token)

需要 Bearer Token 的端点

  • POST /certs/generate/ — 签发客户端证书
  • POST /certs/revoke/ — 吊销证书
  • POST /renew/ — 续期
  • POST /upgrade/ — 升级 Plan
  • GET/POST/PUT/DELETE /plans/ — 方案管理
  • GET /stats/ — 统计
  • GET/DELETE /webhooks/ — Webhook 管理
  • POST /webhooks/register/ — 注册 Webhook

调用格式

curl https://foren.dev/license/api/coforen/health/

需要鉴权时:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://foren.dev/license/api/coforen/stats/

请求 / 响应均为 application/json,UTF-8。

通用响应

成功:

{"ok": true, ...}

失败:

{"ok": false, "error_code": "snake_case_id", "message": "..."}

完整规范

请参考完整的 LICENSE_API.md(开发向),包含所有 14 个端点的:

  • 完整 URL / 方法
  • 请求参数 schema
  • 响应字段说明
  • 错误码
  • curl 示例