# Conectar cuentas de creadores sin flujo de inicio de sesión (@onlyfansapi/auth)

> Conecta cuentas de creadores sin flujo de inicio de sesión propio. Con @onlyfansapi/auth, el creador entra con email, contraseña y 2FA en nuestro modal seguro.

**En resumen**

- El paquete `@onlyfansapi/auth` sustituye meses de ingeniería inversa por una integración rápida para la autenticación de creadores.
- El creador inicia sesión con su email, su contraseña y 2FA dentro de nuestro modal seguro.
- Cada cuenta conectada recibe una IP móvil dedicada (EE. UU. o Reino Unido), sin rotación, desde el plan Basic.
- El modal gestiona la 2FA, y los webhooks (desde el plan Basic) te avisan casi en tiempo real de verificaciones como `accounts.otp_code_required`.

Puedes conectar cuentas de creadores sin crear un flujo de inicio de sesión propio si implementas la biblioteca `@onlyfansapi/auth`. Este paquete de 1,5 kB ofrece una configuración independiente del framework en la que el creador inicia sesión con su email, su contraseña y 2FA dentro de nuestro modal seguro.

**Puntos clave**

- El paquete `@onlyfansapi/auth` sustituye meses de ingeniería inversa por una integración rápida para la autenticación de creadores.
- El creador inicia sesión con su email, su contraseña y 2FA dentro de nuestro modal seguro.
- Cada cuenta conectada recibe una IP móvil dedicada (EE. UU. o Reino Unido), sin rotación, desde el plan Basic.
- El modal gestiona la 2FA, y los webhooks (desde el plan Basic) te avisan casi en tiempo real de verificaciones como `accounts.otp_code_required`.

## Una alternativa mejor a crear flujos de autenticación propios para OnlyFans

La alternativa a crear un flujo de autenticación propio para OnlyFans es la biblioteca oficial [Auth](https://fansapi.com/auth), creada para esto: gestiona todo el proceso de inicio de sesión y verificación dentro de nuestro modal seguro. Las agencias y los desarrolladores que crean CRM o herramientas de chat suelen pasar meses intentando hacer ingeniería inversa de las solicitudes del cliente. Según se informa, estos flujos propios dejan de funcionar cuando la plataforma actualiza su inicio de sesión. Nuestra [guía de la API de OnlyFans](/es/blog/guia-api-onlyfans-crear-app-sin-ingenieria-inversa) explica por qué la ingeniería inversa sigue fallando.

En lugar de mantener una infraestructura frágil, los equipos usan OnlyFansAPI para autenticar a los usuarios directamente. OnlyFansAPI ejecuta cada cuenta conectada en una IP móvil dedicada (desde el plan Basic). Como el creador inicia sesión dentro de nuestro modal seguro, nunca guardas credenciales en texto plano en tus propios servidores. OnlyFansAPI lleva más de 5 años funcionando sin ningún baneo.

## Por qué fallan los sistemas de autenticación internos

Los sistemas de autenticación propios exigen un mantenimiento constante por las protecciones anti-bot.

Según se informa, la plataforma marca o limita los intentos de inicio de sesión que proceden de IP de centros de datos estándar. La autenticación multifactor añade otra capa de complejidad. Los formularios propios tienen que gestionar mediante programación los códigos de autenticador basados en tiempo, los OTP por email, los códigos SMS y las verificaciones faciales.

## ¿Qué es @onlyfansapi/auth?

El paquete [`@onlyfansapi/auth` en npm](https://www.npmjs.com/package/@onlyfansapi/auth) es la biblioteca de autenticación oficial de la OnlyFans API. El script de 1,5 kB carga en 2 ms con internet 4G e incluye definiciones completas de TypeScript. Funciona de forma nativa con React, Vue, Svelte, Angular, Next.js y JavaScript vanilla. Conecta cuentas de OnlyFans; las cuentas de Fansly se conectan mediante `POST /api/fansly/authenticate`.

Una vez integrado, el creador inicia sesión con su email, su contraseña y 2FA dentro de nuestro modal seguro. Tu frontend recibe el `accountId` en el callback `onSuccess`, y el webhook `accounts.connected` entrega el mismo ID a tu backend; la contraseña solo se introduce dentro de nuestro modal seguro. OnlyFansAPI ha gestionado más de 300M de solicitudes a la API y webhooks, y más de 1.100 empresas la usan. Nuestro servicio no es un scraper. OnlyFansAPI usa controles de riesgo automatizados para mantener protegida cada cuenta.

## Cómo implementar el modal seguro

El ciclo de autenticación sigue un handshake de servidor a cliente. Tu clave de API se queda en tu backend, y solo un token de sesión de cliente temporal llega al navegador.

### 1. Crea una sesión de cliente

Tu backend hace una solicitud POST autenticada para generar una sesión. Debes incluir tu clave de API en el encabezado y un `display_name` en el cuerpo.

```http
POST https://app.fansapi.com/api/client-sessions
Authorization: Bearer <key>
Content-Type: application/json

{"display_name": "My Agency CRM", "client_reference_id": "my_crm_model_12345"}
```

### 2. Genera el token

La API devuelve un token de sesión de cliente temporal en `data.token`, con el prefijo `ofapi_cs_`. Envías este token a tu aplicación frontend.

### 3. Abre el modal

Tu frontend llama a `startOnlyFansAuthentication(token, { onSuccess, onError })`. El modal seguro se abre para que el creador introduzca sus datos de autenticación.

### 4. Guarda la cuenta

El callback `onSuccess(data)` se ejecuta cuando termina el inicio de sesión. Devuelve `data.accountId` (los ID de cuenta empiezan por `acct_`) y `data.username`. Vinculas este `accountId` al perfil de usuario en tu base de datos. El `client_reference_id` que definiste en la sesión de cliente vuelve en el webhook `accounts.connected`, para que tu backend pueda asociar la cuenta a tu usuario.

## Gestión de los webhooks de OTP y de sesión

OnlyFansAPI reconecta automáticamente las sesiones caducadas y te avisa de los eventos de sesión y de 2FA mediante webhooks (desde el plan Basic) casi en tiempo real. Cuando una cuenta requiere una verificación fuera de banda, tu aplicación recibe payloads JSON para pedírsela al creador.

Los eventos de webhook de cuenta disponibles incluyen:

- `accounts.connected`: el creador completa con éxito el inicio de sesión en el modal.
- `accounts.reconnected`: la cuenta se reconectó.
- `accounts.session_expired`: la sesión caducó y se reconectó automáticamente.
- `accounts.otp_code_required`: se necesita un código 2FA u OTP para completar la conexión.
- `accounts.face_otp_required`: se necesita una verificación facial; el payload incluye una `face_otp_verification_url`.
- `accounts.authentication_failed`: la sesión caducó y no se pudo reconectar automáticamente, así que el creador debe volver a iniciar sesión.

Cuando recibes un evento `accounts.otp_code_required`, tu sistema lee el estado del payload. En el modal, un código incorrecto muestra la pantalla de reintento. En el flujo de la API, el intento pasa a `wrong_2fa_code_retry` y vuelves a enviar un código nuevo con `PUT /api/authenticate/{attempt_id}`, sin necesidad de reiniciar.

## Autenticación propia frente a OnlyFansAPI

Implementar el flujo de autenticación estándar lleva minutos, frente a los meses que exige una infraestructura propia. Consulta todos los detalles de integración en la documentación [Login with OnlyFans](https://docs.fansapi.com/auth).

| Característica | Flujo de autenticación propio | @onlyfansapi/auth |
| --- | --- | --- |
| **Tiempo de implementación** | Meses | Minutos |
| **Seguridad** | Tus servidores manejan contraseñas en texto plano | Inicio de sesión en un modal seguro |
| **Soporte de MFA** | Requiere parsers propios | Gestión integrada de OTP y 2FA |
| **Arquitectura de proxies** | Tienes que gestionar tus propios proxies | Una IP móvil dedicada por cuenta conectada (desde el plan Basic) |