跳轉到內容
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-tw/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 將永久歸你所有,因此無法退款。但請放心,你將獲得包含終身更新的完整原始碼,可為你自己或客戶構建併發布無限數量的產品。你只需注意不能轉賣程式碼,也不能將倉庫作為啟動模板二次分發。唯一的例外是上線返現——上線一款用 supastack 打造的真實產品並公開分享,在購買後 60 天內達到 5,000 次自然瀏覽或 50 個自然按讚,即可退還已付款項的 50%;詳見條款。

TW
主題