2026-10-04 · 接入指南 · 阅读 1
部署型产品的授权对象是域名而不是设备,校验由客户部署的那台服务器发起。这里说清接口、频率和必须实现的宽限期。
部署型产品(客户把系统装到自己的服务器和域名上)和本地安装程序的授权逻辑完全不同:前者校验的是域名,而且校验动作发生在客户的服务端,不是浏览器端。
接口:POST /api/v1/licenses/verify-domain,请求体只传域名。返回只回答「这个域名此刻是否被授权、授权到什么时候」,不回传授权码等敏感信息。
接入要点:启动时校验一次,失败进入受限模式;之后每 6~24 小时校验一次,不要每次请求都调(接口按 IP 限流);必须实现离线宽限期,网络异常时给 3~7 天缓冲;校验结果缓存在本地,避免上游不可用时完全不可用;不要把校验接口暴露给浏览器,应在服务端调用。
域名要做归一化:去掉协议与路径、转小写。绑了 example.com 但访问 www.example.com 会被视为不同域名,需要一起绑定。