跳轉到主要內容

概觀

InsForge 提供兩種合作夥伴模式,能將我們的後端即服務(Backend-as-a-Service)平台無縫整合到您的應用程式中。無論您是在尋找聯合品牌解決方案,還是完全白標的體驗,我們都有適合您的合作夥伴模式。

合作夥伴模式

聯合品牌合作夥伴關係

非常適合希望將 InsForge 與自身服務一併提供的平台。 整合流程非常簡單——開發者只需一鍵即可連接到 InsForge 平台,不需要複雜的 OAuth 流程。

白標合作夥伴關係

適合尋求對使用者體驗擁有完全掌控權的平台。 提供完整的專案生命週期管理,包括專案儀表板整合。開發者不需要離開您的合作夥伴平台即可完成所有操作。

合作夥伴權益

可擴展的基礎架構

運用我們強大的後端基礎架構,不需要承擔維護和擴展的負擔

彈性的整合方式

從多種整合選項中選擇最適合您應用需求的方式

收益分潤

享有我們為合作夥伴應用提供的具競爭力的收益分潤模式

技術支援

獲得專屬的技術支援與資源,確保整合順利進行

快速開始

1

申請合作夥伴關係

透過我們的合作夥伴信箱提交您的合作夥伴申請。 請註明您感興趣的是聯合品牌還是白標合作夥伴關係。
2

取得合作夥伴憑證

一經核准,您將取得:
  • 合作夥伴 ID:您唯一的合作夥伴識別碼
  • 密鑰:用於 API 存取的身分驗證金鑰
  • 整合文件與支援
3

設定身分驗證

所有 API 請求都必須包含您的密鑰以進行身分驗證:
4

開始整合

根據您的合作夥伴模式,使用我們的 API 端點開始整合。

依合作夥伴類型劃分的功能

聯合品牌功能

在聯合品牌模式下,開發者明確知道自己是 InsForge 平台的使用者(透過相同的電子郵件位址關聯)。登入 InsForge 平台後,開發者對透過合作夥伴建立的專案擁有完整的管理權限,並需要依照 InsForge 的計費方案付費。 合作夥伴平台可以:
  • 將使用者帳號(姓名、電子郵件)與 InsForge 同步
  • 將專案同步至 InsForge
  • 查詢專案連接資訊,以運用已完成的後端能力。

白標功能

在白標模式下,開發者不知道 InsForge 的存在,也無法在 InsForge 平台上看到合作夥伴建立的專案。 合作夥伴平台可以:
  • 建立嵌入式專案
  • 查詢專案中繼資料,以運用已完成的後端能力。
  • 暫停專案
  • 還原專案
  • 刪除專案
  • 取得專案的存取授權權杖
  • 取得專案的使用情況
  • 取得所有合作夥伴專案的彙總使用情況(用於計費)

API 參考

連接使用者帳號

將使用者帳號資訊與 InsForge 同步。
請求主體:
回應:

同步專案

為特定使用者建立或同步專案。
請求主體:
回應:

處理專案數量限制

注意:由於 InsForge 免費方案有專案數量限制,來自合作夥伴平台的專案同步作業可能會失敗。在這種情況下,回應內容將為:
合作夥伴可以引導使用者選擇現有專案進行連接,而不是每次都建立新專案。

取得專案中繼資料

擷取特定專案的連接資訊。
回應:

整合範例

聯合品牌整合流程

以下時序圖說明了聯合品牌合作夥伴關係的整合流程:

白標整合流程

以下時序圖說明了白標合作夥伴關係的整合流程:

參數與回應參考

專案地區數值

InsForge 提供全球化的部署能力。每個專案都可以部署到不同的地區:
  • us-east - 美國東岸
  • us-west - 美國西岸
  • ap-southeast - 亞太東南
  • eu-central - 歐洲中部
未來將依需求增加更多地區。

專案執行個體類型數值

根據您專案的業務需求,InsForge 提供以下資源類型:
  • nano - 用於開發的最小資源
  • micro - 用於測試和開發的基礎資源
  • small - 輕量級工作負載
  • medium - 標準應用程式
  • large - 生產環境工作負載
  • xl - 高效能應用程式
  • 2xl - 企業級應用程式
  • 4xl - 大規模營運
  • 8xl - 關鍵任務系統
  • 16xl - 最高效能

專案狀態數值

專案可以具有以下狀態值:
  • active:專案正在運作且可存取
  • paused:專案已暫停(僅限白標)

錯誤處理

所有 API 端點都會回傳一致的錯誤回應:
常見錯誤情境:
  • 身分驗證憑證無效
  • 找不到專案
  • 請求的操作權限不足
  • 請求參數無效

下一步