跳转到主要内容

概述

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 端点都返回一致的错误响应:
常见错误场景:
  • 身份验证凭证无效
  • 未找到项目
  • 请求的操作权限不足
  • 请求参数无效

下一步