Cómo Empezar

Esta guía le ayudará a configurar y comenzar a usar la API Fanbase en pocos pasos.

Prerrequisitos

• Credenciales de acceso proporcionadas por Fanbase (client_id y client_secret)
• Una URI de redirección configurada y acordada con Fanbase (solo para autenticación SSO)
• Entorno de desarrollo configurado para realizar solicitudes HTTP

Paso 1: Obtener Credenciales

Contacte al equipo de Fanbase para obtener sus credenciales de autenticación:

• client_id: Identificador público de su cliente
• client_secret: Secreto que debe mantenerse confidencial

Paso 2: Elegir Tipo de Integración

Fanbase ofrece diferentes tipos de integración:

Autenticación SSO (Single Sign-On)

Para autenticación de usuarios a través del flujo OAuth 2.0:

1. Configure la URI de redirección con Fanbase
2. Implemente el flujo de autorización
3. Utilice los endpoints de Security para obtener información del usuario

Integraciones Connect

Para integraciones y procesamiento de datos:

1. Obtenga token usando client_credentials
2. Utilice los endpoints de la API Connect
3. Procese datos a través de colas o integraciones directas

Fanmarket

Para integración con servicios de entrega:

1. Configure la integración con Melhor Envio
2. Utilice los servicios de cálculo y gestión de fletes

Paso 3: Configurar URI de Redirección (Solo para SSO)

Si va a utilizar autenticación SSO, defina junto con Fanbase cuál será su URI de redirección (redirect_uri). Esta URI determina la dirección a la que se dirigirán las respuestas de las solicitudes de autenticación.

Ejemplo:

https://su-dominio.com.br/callback

Paso 4: Obtener Token de Acceso

Para Autenticación SSO

El flujo básico de autenticación consiste en:

1. Redirigir al usuario al endpoint de autorización
2. Recibir el código de autorización en el callback
3. Intercambiar el código por tokens a través del endpoint de tokens
4. Validar y utilizar tokens según sea necesario

Ejemplo Rápido:

const authUrl = `{login-producao}/authorize?response_type=code&scope=openid profile&client_id=su_client_id&redirect_uri=https://su-dominio.com.br/callback`;

window.location.href = authUrl;

Para Integraciones Connect

Obtenga token usando client_credentials:

const response = await fetch('{security-producao}/api/token?grant_type=client_credentials&client_id=su_client_id&client_secret=su_client_secret', {
  method: 'POST'
});

const { access_token } = await response.json();

Próximos Pasos

Autenticación SSO:

• Solicitud de Autenticación
• Endpoint de Tokens
• Validación del ID Token
• UserInfo y Profile

Integraciones:

• Obtener Token
• API Connect
• Fanmarket

Referencias:

• Flujo de Autorización
• Mensajes de Error
• Ejemplos de Implementación