Introducción

¡Bienvenido a la documentación de la API Fanbase! Esta guía proporciona toda la información necesaria para integrar su sistema con la plataforma Fanbase, incluyendo autenticación, seguridad, integraciones y servicios.

Sobre la Plataforma Fanbase

Fanbase ofrece una plataforma completa de gestión de identidades, integraciones y servicios a través de múltiples APIs especializadas:

• Autenticación: Sistema de Single Sign-On (SSO) basado en OpenID Connect y OAuth 2.0
• Security: Endpoints de seguridad y gestión de identidades
• Connect: API para integraciones, procesamiento de datos y exportación
• Fanmarket: Integración con servicios de entrega y comercio electrónico

URLs de los Entornos

Las variables siguientes se utilizan a lo largo de esta documentación para representar las direcciones de cada entorno y servicio:

Autenticación (Login)

Producción:

• {login-producao} = https://login.{seu-dominio}.com.br

Homologación:

• {login-homologacao} = https://login-{seu-dominio}.fantest.com.br

Security (SSO)

Producción:

• {security-producao} = https://security.fanbase.com.br

Homologación:

• {security-homologacao} = https://security.fantest.com.br

Connect (Integraciones)

Producción:

• {connect-producao} = https://connect.fanbase.com.br

Homologación:

• {connect-homologacao} = https://connect.fantest.com.br

Fanmarket

Producción:

• {fanmarket-producao} = https://fanmarketapi.fanbase.com.br

Homologación:

• {fanmarket-homologacao} = https://fanmarketapi.fantest.com.br

Servicios Disponibles

Autenticación

Sistema de autenticación basado en OpenID Connect que utiliza el Authorization Code Flow, ofreciendo:

• Seguridad mejorada: los tokens no se exponen al navegador del usuario
• Validación de firma: todos los tokens están firmados y pueden ser validados
• Control de acceso: gestión granular de permisos a través de scopes

Ver documentación completa →

Security (SSO)

API de seguridad y gestión de identidades que ofrece:

• Obtención de tokens de acceso (client_credentials)
• Recuperación de información básica del usuario (UserInfo)
• Acceso al perfil completo del usuario (Profile)

Ver documentación completa →

Connect

API para integraciones y procesamiento de datos que incluye:

• Queue: Sistema de colas para procesamiento asíncrono (webhooks, validaciones, notificaciones)
• Integraciones: Procesamiento de transacciones y registros en lote
• Exportación: Exportación de datos de surveys y filtros
• Aplicaciones: Registro de eventos y dispositivos móviles

Ver documentación completa →

Fanmarket

Integración con servicios de entrega a través de Melhor Envio:

• Cálculo y gestión de fletes
• Integración con múltiples transportadoras
• Gestión de entregas y seguimiento

Ver documentación completa →

Flujo de Autenticación

El sistema utiliza el Authorization Code Flow de OpenID Connect, que garantiza la seguridad al no exponer tokens directamente en el navegador del usuario. El flujo completo incluye:

1. Solicitud de autenticación en el endpoint de login
2. Redirección del usuario al login
3. Recepción del código de autorización
4. Intercambio del código por tokens (id_token y access_token)
5. Validación del ID Token
6. Utilización de los tokens para acceder a endpoints protegidos

Próximos Pasos

Para Autenticación y Security:

1. Obtenga sus credenciales de autenticación
2. Configure su URI de redirección
3. Implemente el flujo de autenticación
4. Integre los endpoints de Security

Para Connect:

1. Obtenga token de acceso
2. Explore los endpoints disponibles
3. Implemente integraciones específicas

Para Fanmarket:

1. Configure integración con Melhor Envio
2. Utilice los servicios de entrega