跳转到内容
supastack
浏览文档

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/mobile/developers.md (or send Accept: text/markdown).

开发者工具

在应用中管理 API 密钥、Webhook、计划任务、域名与审计日志。

询问本指南
打开方式

API 密钥

/api/mobile/api-keys 上的 GET 与 POST 列出并创建工作区 API 密钥;DELETE 按 id 吊销。创建时明文密钥只返回一次,此后不再显示。密钥接受 read 或 write 作用域,expiresInDays 取值被限制在 0 到 3650 —— 0 表示永不过期。仅所有者与管理员。

Webhook 与投递记录

/api/mobile/webhooks 上的 GET 与 POST 管理端点订阅;创建时签名密钥只返回一次。每个端点支持删除、查看投递列表(含尝试次数、响应码与最近错误)以及 ping 操作。十三种事件类型覆盖 AI 任务、账单、电商订单、已连接账户、内容、域名、功能请求、邀请、成员与 Stripe Connect。

工作区计划任务

/api/mobile/schedules 上的 GET 与 POST 列出并按工作区加类型 upsert 计划任务 —— {cron, enabled};DELETE 按 id 删除。cron 表达式按 UTC 运行;切换开关时必须连带重发 cron,因为 upsert 是整体覆盖;错过的运行会累积在计划任务记录上。

自定义域名

/api/mobile/domains 上的 GET 与 POST 列出已配置域名及其 CNAME 目标,并带一个 enabled 标志 —— 提供商未配置时报告为关。DELETE 删除域名,POST refresh 重新检查其 DNS。

审计日志

GET /api/mobile/audit 返回工作区的审计记录 —— 仅所有者与管理员 —— 每行含标签、操作者邮箱与目标类型。客户端默认请求一百行。

验证与排障

创建一个密钥、触发一次 Webhook ping、切换一个计划任务。全部五个界面都属于所有者/管理员领域 —— 验证普通成员被拒绝,而不是看到过期数据。

常见问题

14 个问题

supastack 是什么?

supastack 是用于构建 AI 驱动 SaaS 产品的模块化基础。它把通用基础设施整合在一起,让你专注于产品专属的功能。

它支持 Web 和移动端吗?

支持。supastack 包含 Next.js 与 Expo 应用,作为 Web 与移动端体验的起点。

包含哪些认证方式?

Better Auth 覆盖邮箱/密码、OTP 与社交登录。个人工作区随账户一起开通,产品记录从第一天起就有边界。

AI 是如何支持的?

supastack 包含可配置的多供应商 AI、用量追踪、预算,以及加密的自带密钥(BYOK)支持。

订阅如何处理?

对于基于该套件构建的产品,Stripe 计费、订阅与权限构成付费访问的基础。供应商密钥仅存于服务端。

我的产品专属代码放在哪里?

产品专属功能保留在独立的代码库中,产品通过配置接入 supastack 的基础模块。

supastack 如何定价?

套件为一次性购买、终身更新:单栈 249 美元(Next.js(Web)、Expo(iOS 与 Android)、Tauri(macOS 与 Windows 桌面)仓库任选其一),双栈 398 美元(任选两个仓库),或完整套装 399 美元(全部三个仓库与完整 monorepo),每个额外开发者席位 75 美元。套件本身没有订阅。本站结账后通过邮件发送许可证密钥,仓库访问通过 GitHub 邀请授予。

工作区如何界定我的数据?

用户记录按 workspaceId 划定边界。身份、权限、AI 用量、计费事件与审计条目都留在个人工作区边界内。

后台任务如何工作?

Trigger.dev 是明确的任务运行时。JobRunner 契约只承诺 enqueue、status 与 cancel——工作流语义保持 Trigger.dev 专有且显式。

邮件与营销触达有何不同?

事务性邮件覆盖产品工作流,如任务完成通知。冷触达与营销活动属于产品自身的范畴,不在本套件的邮件模块内。

移动端购买如何运作?

移动端已支持 RevenueCat 原生购买和恢复购买,访问权限由服务端验证。发布前需配置商店账户并完成设备测试。Web 计费保持独立。

AI 供应商密钥存放在哪里?

自带密钥凭证经过加密且仅存于服务端。密钥在日志中被脱敏;用量与预算在工作区级别保持可见。

结账支持哪些付款方式?

Stripe 托管结账接受银行卡,在 Stripe 账户启用后还可提供支付宝与微信支付——方便中国买家。钱包授权为异步确认,付款完成后许可证页面会立即更新。

我能申请退款吗?

获得代码仓库访问权限后,supastack 将永久归你所有,因此无法退款。但请放心,你将获得包含终身更新的完整源代码,可为你自己或客户构建并发布无限数量的产品。你只需注意不能转卖代码,也不能将仓库作为启动模板二次分发。

CN
主题