服务端 API 规范 | Adapty 文档

服务端 API 请求

Adapty 的服务端 API 使您能够以编程方式访问和管理订阅数据,从而与现有服务和基础设施实现无缝集成。无论是跨平台同步数据、授予访问等级,还是在 Stripe 中验证购买,此 API 都提供了保持系统同步并提升用户参与度所需的工具。

Postman 集合与环境

为了简化服务端 API 的使用,我们准备了 Postman 集合和环境文件,你可以下载并导入到 Postman 中。

  • Request Collection(请求集合):包含 Adapty 服务端 API 中所有可用的请求。请注意,其中使用了变量,你可以在环境中定义这些变量的值。
  • Environment(环境):包含一组变量,你只需定义一次其值即可。我们为服务端 API、Web API 和分析导出 API 准备了统一的环境配置,方便你使用。将该环境设为活跃状态后,Postman 将自动在请求中替换已定义的变量值。

有关如何将集合和环境导入 Postman 的详细说明,请参阅 Postman 文档

使用的变量

我们为服务端 API、Web API 和分析导出 API 创建了统一的环境,以简化您的工作流程。以下是服务端 API 的专用变量:

变量描述示例值
secret_api_key可在 App settingsSecret key 字段中找到。secret_live_Pj1P1xzM.2CvSvE1IalQRFjsWy6csBVNpH33atnod
adapty-customer-user-id您在系统中使用的用户 ID。在 Adapty 看板中,可在用户画像的 Customer user ID 字段中找到。john.doe@example.com
adapty-profile-idAdapty 分配的用户 ID。在 Adapty 看板中,可在用户画像的 Adapty ID 字段中找到。3286abd3-48b0-4e9c-a5f6-ac0a006333a6
Adapty-platform用户使用您应用的平台。可选值:iOSmacOSiPadOSvisionOSAndroidwebiOS
stripe_token代表唯一购买行为的 Stripe 对象 Token,例如订阅(sub_XXX)或付款意图(pi_XXX)。sub_1JY8xLLy6P12345a

下一步:请求: