接口

GET /api/license/{host}

返回指定主机名对应根域名的有效授权令牌。仅返回状态为 active 且已签发令牌的授权。

请求

  • host：路径参数，可传完整主机名或域名（如 example.com、www.example.com、https://example.com/）。服务端会规范化并计算根域名。
  • 无需鉴权，支持跨域（响应带 Access-Control-Allow-Origin: *）。
  • 限流：按客户端 IP 每分钟最多 60 次，超出返回 429。

响应

状态码响应体说明
200{"token":"<token>"}找到有效授权。
404{"error":"not_found"}域名无效或无有效授权。
429{"error":"rate_limited"}超出限流。

响应 Content-Type: application/json; charset=utf-8。

示例

GET /api/license/example.com

200 OK
{"token":"eyJ2IjoxLCJsaWQiOiI0MiIsImRvbWFpbiI6ImV4YW1wbGUuY29tIiwicGxhbiI6InJlbW92ZS1wb3dlcmVkLWJ5IiwiaWF0IjoxNzYwMDAwMDAwLCJleHAiOjB9.<signature>"}
GET /api/license/unknown.example

404 Not Found
{"error":"not_found"}

说明

该接口返回的令牌与购买完成后下发的令牌一致，可直接用于 X1 的离线校验。令牌格式见「授权令牌格式与校验」。