# Connecter des comptes créateurs sans flux de connexion (@onlyfansapi/auth)

> Connectez vos comptes créateurs sans flux de connexion maison. Via @onlyfansapi/auth, le créateur saisit e-mail, mot de passe, 2FA dans notre modale sécurisée.

**En bref**

- Le package `@onlyfansapi/auth` remplace des mois de rétro-ingénierie par une intégration rapide pour l'authentification des créateurs.
- Le créateur se connecte avec son e-mail, son mot de passe et la 2FA dans notre modale sécurisée.
- Chaque compte connecté reçoit une IP mobile dédiée (US ou UK), sans rotation, à partir du plan Basic.
- La modale gère la 2FA, et les webhooks (à partir du plan Basic) vous notifient en quasi temps réel des vérifications comme `accounts.otp_code_required`.

Vous pouvez connecter des comptes créateurs sans construire de flux de connexion sur mesure en intégrant la bibliothèque `@onlyfansapi/auth`. Ce package de 1,5 kB offre une mise en place indépendante du framework : le créateur se connecte avec son e-mail, son mot de passe et la 2FA dans notre modale sécurisée.

**Points clés**

- Le package `@onlyfansapi/auth` remplace des mois de rétro-ingénierie par une intégration rapide pour l'authentification des créateurs.
- Le créateur se connecte avec son e-mail, son mot de passe et la 2FA dans notre modale sécurisée.
- Chaque compte connecté reçoit une IP mobile dédiée (US ou UK), sans rotation, à partir du plan Basic.
- La modale gère la 2FA, et les webhooks (à partir du plan Basic) vous notifient en quasi temps réel des vérifications comme `accounts.otp_code_required`.

## Une meilleure alternative aux flux d'authentification sur mesure pour OnlyFans

L'alternative à un flux d'authentification sur mesure pour OnlyFans est la bibliothèque officielle [Auth](https://fansapi.com/auth), conçue pour cela : elle gère tout le processus de connexion et de vérification dans notre modale sécurisée. Les agences et les développeurs qui construisent des CRM ou des outils de chat passent souvent des mois à tenter de faire de la rétro-ingénierie sur les requêtes client. Selon de nombreux rapports, ces flux sur mesure cesseraient de fonctionner lorsque la plateforme met à jour sa procédure de connexion. Notre [guide de l'API OnlyFans](/fr/blog/guide-api-onlyfans-application-sans-reverse-engineering) explique pourquoi le reverse engineering échoue sans cesse.

Plutôt que de maintenir une infrastructure fragile, les équipes utilisent OnlyFansAPI pour authentifier directement les utilisateurs. OnlyFansAPI fait tourner chaque compte connecté sur une IP mobile dédiée (à partir du plan Basic). Comme le créateur se connecte dans notre modale sécurisée, vous ne stockez jamais d'identifiants en clair sur vos propres serveurs. OnlyFansAPI fonctionne depuis plus de 5 ans sans aucun bannissement.

## Pourquoi les systèmes d'authentification maison échouent

Les systèmes d'authentification sur mesure exigent une maintenance constante à cause des protections anti-bot.

Selon de nombreux rapports, la plateforme signalerait ou limiterait les tentatives de connexion provenant d'IP de datacenter classiques. L'authentification multifacteur ajoute une couche de complexité supplémentaire. Les formulaires sur mesure doivent gérer par programme les codes d'authentificateur temporels, les OTP par e-mail, les codes SMS et les vérifications faciales.

## Qu'est-ce que @onlyfansapi/auth ?

Le package [`@onlyfansapi/auth` sur npm](https://www.npmjs.com/package/@onlyfansapi/auth) est la bibliothèque d'authentification officielle de l'OnlyFans API. Ce script de 1,5 kB se charge en 2 ms sur une connexion 4G et inclut des définitions TypeScript complètes. Il fonctionne nativement avec React, Vue, Svelte, Angular, Next.js et JavaScript vanilla. Il connecte les comptes OnlyFans ; les comptes Fansly se connectent via `POST /api/fansly/authenticate`.

Une fois l'intégration faite, le créateur se connecte avec son e-mail, son mot de passe et la 2FA dans notre modale sécurisée. Votre frontend reçoit l'`accountId` dans le callback `onSuccess`, et le webhook `accounts.connected` transmet le même ID à votre backend ; le mot de passe n'est saisi que dans notre modale sécurisée. OnlyFansAPI a traité plus de 300 M de requêtes API et de webhooks, et plus de 1 100 entreprises l'utilisent. Notre service n'est pas un scraper. OnlyFansAPI utilise des contrôles de risque automatisés pour garder chaque compte protégé.

## Comment intégrer la modale sécurisée

Le cycle d'authentification suit une poignée de main serveur-client. Votre clé API reste sur votre backend, et seul un token de session client temporaire parvient au navigateur.

### 1. Créer une session client

Votre backend envoie une requête POST authentifiée pour générer une session. Vous devez inclure votre clé API dans l'en-tête et un `display_name` dans le corps.

```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. Générer le token

L'API renvoie un token de session client temporaire dans `data.token`, préfixé par `ofapi_cs_`. Vous envoyez ce token à votre application frontend.

### 3. Lancer la modale

Votre frontend appelle `startOnlyFansAuthentication(token, { onSuccess, onError })`. La modale sécurisée s'ouvre pour que le créateur saisisse ses informations d'authentification.

### 4. Enregistrer le compte

Le callback `onSuccess(data)` se déclenche une fois la connexion terminée. Il renvoie `data.accountId` (les ID de compte commencent par `acct_`) et `data.username`. Vous associez cet `accountId` au profil utilisateur dans votre base de données. Le `client_reference_id` que vous avez défini sur la session client revient dans le webhook `accounts.connected`, ce qui permet à votre backend de rattacher le compte à votre utilisateur.

## Gérer les webhooks d'OTP et de session

OnlyFansAPI reconnecte automatiquement les sessions expirées et vous notifie des événements de session et de 2FA via des webhooks (à partir du plan Basic) en quasi temps réel. Quand un compte exige une vérification hors bande, votre application reçoit des payloads JSON pour solliciter le créateur.

Les événements webhook de compte disponibles incluent :

- `accounts.connected` : le créateur termine avec succès la connexion dans la modale.
- `accounts.reconnected` : le compte a été reconnecté.
- `accounts.session_expired` : la session a expiré et a été reconnectée automatiquement.
- `accounts.otp_code_required` : un code 2FA ou OTP est nécessaire pour terminer la connexion.
- `accounts.face_otp_required` : une vérification faciale est nécessaire ; le payload inclut une `face_otp_verification_url`.
- `accounts.authentication_failed` : la session a expiré et n'a pas pu être reconnectée automatiquement, le créateur doit donc se reconnecter.

Quand vous recevez un événement `accounts.otp_code_required`, votre système lit l'état indiqué dans le payload. Dans la modale, un code erroné affiche l'écran de nouvelle tentative. Dans le flux API, la tentative passe à `wrong_2fa_code_retry` et vous soumettez un nouveau code avec `PUT /api/authenticate/{attempt_id}`, sans avoir à tout recommencer.

## Comparer l'authentification sur mesure à OnlyFansAPI

Mettre en place le flux d'authentification standard prend quelques minutes, contre les mois nécessaires pour une infrastructure sur mesure. Consultez tous les détails d'intégration dans la documentation [Login with OnlyFans](https://docs.fansapi.com/auth).

| Fonctionnalité | Flux d'authentification sur mesure | @onlyfansapi/auth |
| --- | --- | --- |
| **Délai de mise en place** | Des mois | Quelques minutes |
| **Sécurité** | Vos serveurs manipulent les mots de passe en clair | Connexion via une modale sécurisée |
| **Prise en charge de la MFA** | Exige des parseurs sur mesure | Gestion intégrée des OTP et de la 2FA |
| **Architecture proxy** | Vous devez gérer vos propres proxys | Une IP mobile dédiée par compte connecté (à partir du plan Basic) |