SuperAPI AI 工具集

freemius-core

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

用途:把 Freemius 计费接入 JS/TS 后端,让已登录用户购买套餐,并可靠回答“该用户当前是否有有效权益”。遵循官方 JS SDK 集成指南,示例用 Hono 编写,但适用于任何支持 Web 标准 Request/Response 路由的框架。

主要能力:四个构建块——1) user_fs_entitlement 权益表(Prisma/SQL/Drizzle);2) 服务端结账创建 POST /api/checkout;3) 购买处理(重定向处理器 + overlay 端点);4) 许可证生命周期同步的 Webhook 监听 POST /api/webhooks/freemius。

使用方式:安装 npm install @freemius/sdk,在服务端构造 Freemius 客户端(productId、apiKey、secretKey、publicKey 来自环境变量);用 freemius.checkout.create() 创建结账并 serialize() 返回 link/options;购买后用 freemius.purchase.retrievePurchase(licenseId) 与 toEntitlementRecord() 同步权益;用 getUserEntitlement() 对受保护功能返回 402。沙箱用独立 FREEMIUS_SANDBOX 环境变量控制,不要绑定 NODE_ENV。

适用场景:需要订阅、一次性/加购或积分变现,并对功能或端点做付费门控的 JS/TS 应用。

限制:所有 SDK/API 调用必须服务端执行,密钥不得进入浏览器;本地数据库只是镜像,Freemius 才是计费状态来源;Webhook 为必需;需在 Freemius 开发者仪表盘配置 Webhook URL 与结账重定向 URL。具体价格、平台支持等资料未提供。