Como Começar
Este guia irá ajudá-lo a configurar e começar a usar a API Fanbase em poucos passos.
Pré-requisitos
- Credenciais de acesso fornecidas pela Fanbase (client_id e client_secret)
- Uma URI de redirecionamento configurada e acordada com a Fanbase (apenas para autenticação SSO)
- Ambiente de desenvolvimento configurado para fazer requisições HTTP
Passo 1: Obter Credenciais
Entre em contato com a equipe da Fanbase para obter suas credenciais de autenticação:
- client_id: Identificador público do seu cliente
- client_secret: Segredo que deve ser mantido em sigilo
Passo 2: Escolher o Tipo de Integração
A Fanbase oferece diferentes tipos de integração:
Autenticação SSO (Single Sign-On)
Para autenticação de usuários através do fluxo OAuth 2.0:
- Configure a URI de redirecionamento com a Fanbase
- Implemente o fluxo de autorização
- Utilize os endpoints de Security para obter informações do usuário
Integrações Connect
Para integrações e processamento de dados:
- Obtenha token usando client_credentials
- Utilize os endpoints da API Connect
- Processe dados através de filas ou integrações diretas
Fanmarket
Para integração com serviços de entrega:
- Configure integração com Melhor Envio
- Utilize os serviços de cálculo e gestão de fretes
Passo 3: Configurar URI de Redirecionamento (Apenas para SSO)
Se você vai utilizar autenticação SSO, defina em conjunto com a Fanbase qual será a sua URI de redirecionamento (redirect_uri). Esta URI determina o endereço para o qual serão direcionadas as respostas das solicitações de autenticação.
Exemplo:
https://seu-dominio.com.br/callbackPasso 4: Obter Token de Acesso
Para Autenticação SSO
O fluxo básico de autenticação consiste em:
- Redirecionar o usuário para o endpoint de autorização
- Receber o código de autorização no callback
- Trocar o código por tokens através do endpoint de tokens
- Validar e utilizar os tokens conforme necessário
Exemplo Rápido:
javascript
const authUrl = `{login-producao}/authorize?response_type=code&scope=openid profile&client_id=seu_client_id&redirect_uri=https://seu-dominio.com.br/callback`;
window.location.href = authUrl;Para Integrações Connect
Obtenha token usando client_credentials:
javascript
const response = await fetch('{security-producao}/api/token?grant_type=client_credentials&client_id=seu_client_id&client_secret=seu_client_secret', {
method: 'POST'
});
const { access_token } = await response.json();