API GraphQL

A API GraphQL de Recompensas foi projetada para suportar e alimentar a Biblioteca JavaScript Front End de Recompensas (SDK), que fornece uma experiência de Recompensas pronta para uso e em constante evolução. Todas as marcas que usam Recompensas têm acesso à API GraphQL, garantindo flexibilidade para diferentes necessidades técnicas e abordagens de integração.
Para a maioria dos casos de uso, recomendamos usar a Biblioteca JavaScript Front End de Recompensas (SDK). O SDK é mantido ativamente pela equipe de engenharia de Recompensas e beneficia-se do desenvolvimento contínuo de recursos, melhorias e correções de bugs. Ao usar o SDK, as marcas podem automaticamente aproveitar novas funcionalidades conforme elas se tornam disponíveis, sem a necessidade de implementar ou manter essas características por conta própria.
A API GraphQL pode ser usada como complemento ao SDK ou como uma solução independente em casos onde funcionalidade customizada é necessária que não é atualmente suportada pelo SDK. Ao considerar o uso direto da API GraphQL, é útil definir claramente o caso de uso pretendido, pois funcionalidade similar ou equivalente pode já existir ou estar planejada dentro do SDK.
Escolher o SDK permite que as marcas se concentrem em sua experiência principal enquanto dependem de uma equipe dedicada de Recompensas para gerenciar os recursos subjacentes de front-end de Recompensas. Marcas que constroem um front-end de Recompensas totalmente customizado usando a API GraphQL ganham maior controle e flexibilidade, mas também serão responsáveis por implementar e manter novos recursos completos conforme eles são introduzidos.
Este documento fornece uma referência técnica completa para integração com a API GraphQL do Fasttrack Rewards. Ele cobre autenticação usando tokens JWT, consultas e mutações disponíveis para acessar e gerenciar recompensas, bônus, desafios, itens da loja e dados do usuário, bem como assinaturas em tempo real. Desenvolvedores podem usar este guia para entender o esquema, construir requisições de API e implementar os recursos de recompensas.

🌟 Playground:

Playground: https://<brand-name>.ft-crm.com/rewards-graphql-api/

🔒 Autenticação

Para acessar a API:
  1. Você deve passar um token JWT com as seguintes declarações:
    1. iat (Issued At): Timestamp Unix
    2. exp (Expiration): Timestamp Unix
    3. user_id: String ou inteiro
  2. O JWT deve ser assinado com o JWT-secret fornecido ao Fasttrack.
No Playground:
  1. Vá para a seção Headers.
  2. Adicione: