API per sviluppatori NowG

L'API NowG consente di trasmettere in streaming il comportamento dei giocatori alla piattaforma e di ricevere in risposta, tramite webhook, gli output del modello (punteggi di coorte, avvisi di tilt e segnali di qualità per gli affiliati). Si tratta di un'API JSON/HTTPS; ogni richiesta è associata a un singolo tenant tramite il relativo token di autorizzazione. URL di base: https://api.nowg.net/v1.

Autenticazione

Tutte le richieste utilizzano un token bearer con ambito a un solo tenant. Genera e ruota le chiavi dalla dashboard sotto Impostazioni → API. Invialo nel Authorization intestazione: Authorization: Bearer $KEYLe chiavi sono specifiche per l'ambiente (test/produzione) e non scadono mai finché non vengono ruotate.

Limiti tariffari

L'ingestione è limitata a 500 richieste/secondo per inquilino, con possibilità di accelerazione fino a 1,000. I batch contano come una richiesta. Quando la velocità è limitata, ricevi 429 con una Retry-After intestazione — fai un passo indietro e riprova; l'ingestione è idempotente, quindi le riproduzioni sono sicure.

Eventi dei giocatori

Trasmetti in streaming gli eventi comportamentali in tempo reale in modo che i modelli possano valutare l'appetito per la volatilità, il rischio di tilt e la qualità della coorte. Gli eventi vengono deduplicati da event_id.

Importazione in batch

Riempimento della cronologia tramite POST di un array fino a Eventi 1,000 a /v1/players/events/batch. La risposta restituisce per elemento accepted and deduped conteggi. L'ordine non ha importanza: gli eventi sono contrassegnati da timestamp ts, non arrivo.

Deduplica

Ogni evento porta con sé un event_id tu controlli. NowG lo memorizza per 30 giorni; una ripetizione entro tale periodo viene silenziosamente ignorata (contata sotto dedupedCiò rende i tentativi, le code "almeno una volta" e le riproduzioni completamente sicuri.

Webhook: punteggi di coorte

Quando il modello di ricalcolo del punteggio di un giocatore è completato, NowG POSTa un cohort.scored evento al tuo URL webhook con punteggi di volatilità, tilt-risk e qualità dell'affiliato (0–1). Registra l'URL sotto Impostazioni → Webhook.

Webhook: avvisi di inclinazione

A tilt.alert L'evento si attiva quando un giocatore supera la soglia di frustrazione configurata, comportando l'intervento raccomandato (tempo di ricarica, richiesta di limite, nessun bonus). Ogni avviso viene registrato per la verifica da parte di Compliance Guardian.

Webhook: configurazione del postback

Per inviare segnali di qualità affiliata al tuo tracker, aggiungi il suo URL di postback sotto Impostazioni → Integrazioni con la {click_id} and {quality_score} macro. NowG la invia da server a server ogni volta che il punteggio di una coorte cambia in modo significativo.