SuperAPI AI 工具集

autumn-setup

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:在项目中接入 Autumn(基于 Stripe 的计费与权益层),完成安装 SDK、创建 Autumn 客户、接入支付流程。

准备:先检查项目根目录是否存在 autumn.config.ts,若不存在,运行 npx atmn init 登录并生成该文件(保存 API 密钥并同步配置),随后参考其中产品与功能 ID。

步骤一:分析代码库,识别语言(TypeScript/JavaScript、Python 或其他)、框架(Next.js、Hono 或其他)、是否含 React 前端(检查 package.json),以及客户模型对应个人用户还是组织(检查 auth 与 org/team/workspace 模型)。若无法判断,需询问用户选择用户(B2C)或组织(B2B)。

步骤二:写入集成代码前,先向用户展示简短计划,包括识别到的技术栈、客户类型判断及理由、所选路径(React 全栈或仅后端)、将创建或修改的文件、handler/provider/客户创建位置及支付流程接入位置。须等用户确认后再编码。

路径 A:React + Node.js 全栈。安装 SDK:npm install autumn-js。服务端挂载 handler 生成 /api/autumn/* 端点,identify 返回用户或组织 ID 与名称、邮箱,Next.js 用 autumn-js/next、Hono 用 autumn-js/hono、其他框架用 autumn-js/backend 泛型 handler。客户端用 AutumnProvider 包裹应用,跨域时传 backendUrl。用 useCustomer 创建并获取客户。调用 attach(如 planId、redirectMode: "always")返回 Stripe 支付 URL,支付后授予计划功能。

路径 B:仅后端(Node.js、Python 或其他)。Node.js 用 npm install autumn-js,Python 用 pip install autumn-sdk。分别初始化客户端(TypeScript 用 process.env.AUTUMN_SECRET_KEY,Python 传密钥),使用 customers.getOrCreate / get_or_create 或对应 cURL 创建客户,并用 billing.attach / attach 或 cURL 发起支付。

验证:完成后报告技术栈、所选路径、创建或修改的文件、浏览器中已登录的 Autumn 客户,并提示在 Autumn 控制台查看。Autumn 客户 ID 与内部用户或组织 ID 相同,无需额外存储 ID。文档:https://docs.useautumn.com/llms.txt。未提供的内容暂未说明。