GraphQL API

Rewards GraphQL API 旨在支持和驱动 Rewards 前端 JavaScript 库（SDK），该库提供了一个即用型、持续演进的 Rewards 体验。所有使用 Rewards 的品牌都可以访问 GraphQL API，确保为不同的技术需求和集成方法提供灵活性。
对于大多数使用场景，我们建议使用 Rewards 前端 JavaScript 库（SDK）。SDK 由 Rewards 工程团队积极维护，并受益于持续的功能开发、改进和错误修复。通过使用 SDK，品牌可以自动利用新功能，无需自己实现或维护这些功能。
GraphQL API 可以作为 SDK 的补充使用，或在需要 SDK 当前不支持的自定义功能时作为独立解决方案使用。当考虑直接使用 GraphQL API 时，明确定义预期的使用场景是有帮助的，因为类似或等效的功能可能已经存在于 SDK 中或已在计划中。
选择 SDK 允许品牌专注于他们的核心体验，同时依靠专门的 Rewards 团队来管理底层的 Rewards 前端功能。使用 GraphQL API 构建完全自定义的 Rewards 前端的品牌获得了更大的控制权和灵活性，但也将负责实现和维护新引入的端到端功能。
本文档提供了与 Fasttrack Rewards GraphQL API 集成的完整技术参考。它涵盖了使用 JWT 令牌的身份验证、用于访问和管理奖励、奖金、挑战、商店商品和用户数据的可用查询和变更，以及实时订阅。开发人员可以使用本指南来理解模式、构建 API 请求并实现奖励功能。

🌟 游乐场：

游乐场: https://<brand-name>.ft-crm.com/rewards-graphql-api/

🔒 身份验证

要访问 API：
  1. 您必须传递一个包含以下声明的 JWT 令牌：
    1. iat（签发时间）：Unix 时间戳
    2. exp（过期时间）：Unix 时间戳
    3. user_id：字符串或整数
  2. JWT 必须使用提供给 Fasttrack 的 JWT 密钥进行签名。
在游乐场中：
  1. 转到标题部分。
  2. 添加：