NowG Developer API

Die NowG-API ermöglicht es Ihnen, das Spielerverhalten in die Plattform zu streamen und Modellausgaben – Kohortenbewertungen, Tilt-Warnungen und Affiliate-Qualitätssignale – als Webhooks zurückzuerhalten. Es handelt sich um eine JSON/HTTPS-API; jede Anfrage ist durch ihr Bearer-Token auf einen einzelnen Mandanten beschränkt. Basis-URL: https://api.nowg.net/v1.

Authentifizierung

Alle Anfragen verwenden ein Bearer-Token, das auf einen Mandanten beschränkt ist. Schlüssel können über das Dashboard generiert und rotiert werden. Einstellungen → APISenden Sie es ein in Authorization Header: Authorization: Bearer $KEYDie Schlüssel sind umgebungsbezogen (Test-/Live-Umgebung) und laufen erst ab, wenn sie rotiert werden.

Ratenlimits

Die Aufnahmerate ist begrenzt auf 500 Anfragen/Sekunde Pro Mandant, maximal 1,000 Anfragen. Batches zählen als eine Anfrage. Bei Drosselung erhalten Sie 429 mit einem Retry-After Header — Zurückgehen und erneut versuchen; die Verarbeitung ist idempotent, daher sind Wiederholungen sicher.

Spielerereignisse

Verhaltensereignisse werden in Echtzeit gestreamt, damit die Modelle Volatilitätsaffinität, Tilt-Risiko und Kohortenqualität bewerten können. Ereignisse werden dedupliziert durch event_id.

Batch-Import

Historie durch POST-Anfrage eines Arrays von bis zu 1,000 Ereignisse zu /v1/players/events/batchDie Antwort liefert pro Element accepted und deduped Zählt. Die Reihenfolge spielt keine Rolle – Ereignisse werden mit einem Zeitstempel versehen. ts, nicht Ankunft.

Deduplizierung

Jedes Ereignis birgt eine event_id Sie haben die Kontrolle. NowG speichert die Daten 30 Tage lang; Wiederholungen innerhalb dieses Zeitraums werden stillschweigend ignoriert (werden unter … gezählt). dedupedDadurch sind Wiederholungsversuche, Mindestens-einmal-Warteschlangen und Wiederholungen absolut sicher.

Webhook: Kohortenwerte

Wenn das Modell die Neubewertung eines Spielers abgeschlossen hat, sendet NowG einen POST-Request. cohort.scored Senden Sie ein Ereignis an Ihre Webhook-URL mit Volatilitäts-, Tilt-Risk- und Affiliate-Qualitätsbewertungen (0–1). Registrieren Sie die URL unter Einstellungen → Webhooks.

Webhook: Neigungswarnungen

A tilt.alert Ein Ereignis wird ausgelöst, sobald ein Spieler den konfigurierten Tilt-Schwellenwert überschreitet, und führt zur empfohlenen Intervention (Cooldown, Limit-Aufforderung, Bonusverzicht). Jede Warnung wird zur Überprüfung in Compliance Guardian protokolliert.

Webhook: Postback-Einrichtung

Um Affiliate-Qualitätssignale an Ihren Tracker zurückzumelden, fügen Sie dessen Postback-URL unter folgendem Eintrag hinzu: Einstellungen → Integrationen an. Nach der Installation können Sie HEIC-Dateien mit der {click_id} und {quality_score} Makros. NowG löst sie serverseitig aus, sobald sich ein Kohortenwert wesentlich ändert.