# Creator-Accounts verbinden, ohne einen Login-Flow zu bauen (@onlyfansapi/auth)

> Verbinde Creator-Accounts ohne eigenen Login-Flow. Mit @onlyfansapi/auth meldet sich der Creator mit E-Mail, Passwort und 2FA in unserem sicheren Modal an.

**Kurz gesagt**

- Das Paket `@onlyfansapi/auth` ersetzt monatelanges Reverse Engineering durch eine schnelle Integration für die Creator-Authentifizierung.
- Der Creator meldet sich mit E-Mail, Passwort und 2FA in unserem sicheren Modal an.
- Jeder verbundene Account erhält eine dedizierte mobile IP (USA oder UK), ohne Rotation, ab dem Basic-Plan.
- Das Modal übernimmt die 2FA, und Webhooks (ab dem Basic-Plan) benachrichtigen dich nahezu in Echtzeit über Abfragen wie `accounts.otp_code_required`.

Du kannst Creator-Accounts verbinden, ohne einen eigenen Login-Flow zu bauen, indem du die Bibliothek `@onlyfansapi/auth` einbindest. Das 1,5 kB große Paket bietet ein Framework-unabhängiges Setup, bei dem sich der Creator mit E-Mail, Passwort und 2FA in unserem sicheren Modal anmeldet.

**Das Wichtigste in Kürze**

- Das Paket `@onlyfansapi/auth` ersetzt monatelanges Reverse Engineering durch eine schnelle Integration für die Creator-Authentifizierung.
- Der Creator meldet sich mit E-Mail, Passwort und 2FA in unserem sicheren Modal an.
- Jeder verbundene Account erhält eine dedizierte mobile IP (USA oder UK), ohne Rotation, ab dem Basic-Plan.
- Das Modal übernimmt die 2FA, und Webhooks (ab dem Basic-Plan) benachrichtigen dich nahezu in Echtzeit über Abfragen wie `accounts.otp_code_required`.

## Die bessere Alternative zu eigenen Auth-Flows für OnlyFans

Die Alternative zu einem eigenen Auth-Flow für OnlyFans ist die offizielle [Auth](https://fansapi.com/auth)-Bibliothek, die genau dafür gebaut ist: Sie steuert den gesamten Login- und Verifizierungsprozess in unserem sicheren Modal. Agenturen und Entwickler, die CRM-Systeme oder Chat-Tools bauen, verbringen oft Monate mit dem Versuch, Client-Anfragen per Reverse Engineering nachzubauen. Berichten zufolge funktionieren solche eigenen Flows nicht mehr, sobald die Plattform ihren Login ändert. Unsere [OnlyFans API Anleitung](/de/blog/onlyfans-api-anleitung-app-ohne-reverse-engineering) erklärt, warum Reverse Engineering immer wieder scheitert.

Statt eine fragile Infrastruktur zu pflegen, nutzen Teams OnlyFansAPI, um Nutzer direkt zu authentifizieren. OnlyFansAPI betreibt jeden verbundenen Account auf einer dedizierten mobilen IP (ab dem Basic-Plan). Weil sich der Creator in unserem sicheren Modal anmeldet, speicherst du nie Zugangsdaten im Klartext auf deinen eigenen Servern. OnlyFansAPI läuft seit über 5 Jahren ohne eine einzige Sperre.

## Warum selbst gebaute Authentifizierungssysteme scheitern

Eigene Authentifizierungssysteme verursachen wegen der Anti-Bot-Schutzmaßnahmen ständigen Wartungsaufwand.

Berichten zufolge markiert oder begrenzt die Plattform Login-Versuche, die von gewöhnlichen Rechenzentrums-IPs stammen. Die Multi-Faktor-Authentifizierung bringt eine weitere Ebene an Komplexität. Eigene Formulare müssen zeitbasierte Authenticator-Codes, E-Mail-OTPs, SMS-Codes und Gesichtsverifizierungen programmatisch abwickeln.

## Was ist @onlyfansapi/auth?

Das Paket [`@onlyfansapi/auth` auf npm](https://www.npmjs.com/package/@onlyfansapi/auth) ist die offizielle Authentifizierungsbibliothek der OnlyFans API. Das 1,5 kB große Skript lädt in 2 ms über 4G und enthält vollständige TypeScript-Definitionen. Es funktioniert nativ mit React, Vue, Svelte, Angular, Next.js und Vanilla JavaScript. Es verbindet OnlyFans-Accounts; Fansly-Accounts werden über `POST /api/fansly/authenticate` verbunden.

Nach der Integration meldet sich der Creator mit E-Mail, Passwort und 2FA in unserem sicheren Modal an. Dein Frontend erhält die `accountId` im `onSuccess`-Callback, und der Webhook `accounts.connected` liefert dieselbe ID an dein Backend; das Passwort wird nur in unserem sicheren Modal eingegeben. OnlyFansAPI hat über 300 Mio. API-Anfragen und Webhooks verarbeitet, und mehr als 1.100 Unternehmen nutzen es. Unser Service ist kein Scraper. OnlyFansAPI setzt automatisierte Risikokontrollen ein, um jeden Account geschützt zu halten.

## So implementierst du das sichere Modal

Der Authentifizierungsablauf folgt einem Handshake zwischen Server und Client. Dein API-Schlüssel bleibt in deinem Backend, und nur ein temporäres Client-Session-Token gelangt in den Browser.

### 1. Client-Session erstellen

Dein Backend sendet eine authentifizierte POST-Anfrage, um eine Session zu erzeugen. Du musst deinen API-Schlüssel im Header und einen `display_name` im Body mitschicken.

```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. Token erzeugen

Die API gibt in `data.token` ein temporäres Client-Session-Token mit dem Präfix `ofapi_cs_` zurück. Dieses Token schickst du an deine Frontend-Anwendung.

### 3. Modal starten

Dein Frontend ruft `startOnlyFansAuthentication(token, { onSuccess, onError })` auf. Das sichere Modal öffnet sich, damit der Creator seine Anmeldedaten eingeben kann.

### 4. Account speichern

Der Callback `onSuccess(data)` wird ausgelöst, sobald der Login abgeschlossen ist. Er liefert `data.accountId` (Account-IDs beginnen mit `acct_`) und `data.username`. Diese `accountId` verknüpfst du in deiner Datenbank mit dem Nutzerprofil. Die `client_reference_id`, die du in der Client-Session gesetzt hast, kommt mit dem Webhook `accounts.connected` zurück, sodass dein Backend den Account deinem Nutzer zuordnen kann.

## OTP- und Session-Webhooks verwalten

OnlyFansAPI verbindet abgelaufene Sessions automatisch neu und benachrichtigt dich über Session- und 2FA-Events per Webhook (ab dem Basic-Plan) nahezu in Echtzeit. Wenn ein Account eine Out-of-Band-Verifizierung braucht, erhält deine Anwendung JSON-Payloads, um den Creator dazu aufzufordern.

Verfügbare Account-Webhook-Events sind unter anderem:

- `accounts.connected`: Der Creator schließt den Login im Modal erfolgreich ab.
- `accounts.reconnected`: Der Account wurde neu verbunden.
- `accounts.session_expired`: Die Session ist abgelaufen und wurde automatisch neu verbunden.
- `accounts.otp_code_required`: Ein 2FA- oder OTP-Code wird benötigt, um die Verbindung abzuschließen.
- `accounts.face_otp_required`: Eine Gesichtsverifizierung wird benötigt; die Payload enthält eine `face_otp_verification_url`.
- `accounts.authentication_failed`: Die Session ist abgelaufen und konnte nicht automatisch neu verbunden werden, daher muss sich der Creator erneut anmelden.

Wenn du ein `accounts.otp_code_required`-Event erhältst, liest dein System den Status aus der Payload. Im Modal zeigt ein falscher Code den Bildschirm für einen erneuten Versuch an. Im API-Flow wechselt der Versuch zu `wrong_2fa_code_retry`, und du sendest mit `PUT /api/authenticate/{attempt_id}` einen neuen Code, ohne neu starten zu müssen.

## Eigene Authentifizierung und OnlyFansAPI im Vergleich

Den Standard-Authentifizierungsablauf einzubauen dauert Minuten, eine eigene Infrastruktur dagegen Monate. Alle Details zur Integration findest du in der Dokumentation [Login with OnlyFans](https://docs.fansapi.com/auth).

| Funktion | Eigener Auth-Flow | @onlyfansapi/auth |
| --- | --- | --- |
| **Implementierungsdauer** | Monate | Minuten |
| **Sicherheit** | Deine Server verarbeiten Passwörter im Klartext | Login über sicheres Modal |
| **MFA-Unterstützung** | Erfordert eigene Parser | Integrierte OTP- und 2FA-Verarbeitung |
| **Proxy-Architektur** | Du musst deine eigenen Proxys verwalten | Eine dedizierte mobile IP pro verbundenem Account (ab dem Basic-Plan) |