API développeur NowG
L'API NowG vous permet de diffuser le comportement des joueurs sur la plateforme et de recevoir en retour, via des webhooks, les résultats des modèles (scores de cohorte, alertes de tilt et signaux de qualité d'affiliation). Il s'agit d'une API JSON/HTTPS ; chaque requête est associée à un seul locataire grâce à son jeton d'authentification. URL de base : https://api.nowg.net/v1.
Authentification
Toutes les requêtes utilisent un jeton d'accès limité à un seul locataire. Générez et renouvelez les clés depuis le tableau de bord sous Paramètres → APIEnvoyez-le dans le Authorization en-tête: Authorization: Bearer $KEYLes clés sont liées à un environnement spécifique (test/production) et n'expirent jamais tant qu'elles ne sont pas renouvelées.
Limites de taux
L'ingestion est limitée par le débit de 500 requêtes/seconde par locataire, extensible à 1 000. Les lots comptent pour une seule requête. En cas de limitation, vous recevez 429 avec Retry-After En-tête — reculez et réessayez ; l’ingestion est idempotente, les relectures sont donc sûres.
Événements des joueurs
Diffuser en temps réel les événements comportementaux afin que les modèles puissent évaluer la propension à la volatilité, le risque d'inclinaison et la qualité de la cohorte. Les événements sont dédupliqués par event_id.
Importation par lots
Remplir l'historique en envoyant un tableau contenant jusqu'à Événements 1,000 à /v1/players/events/batchLa réponse renvoie des informations par élément. accepted et deduped Le nombre de comptes. L'ordre n'a pas d'importance — les événements sont horodatés par ts, pas l'arrivée.
Déduplication
Chaque événement comporte un event_id Vous avez le contrôle. NowG le conserve pendant 30 jours ; toute répétition durant cette période est ignorée (comptabilisée sous dedupedCela rend les nouvelles tentatives, les files d'attente « au moins une fois » et les rediffusions totalement sûres.
Webhook : scores de cohorte
Lorsque le modèle de réévaluation d'un joueur est terminé, NowG publie un cohort.scored Ajoutez un événement à votre URL de webhook avec des scores de volatilité, de risque d'inclinaison et de qualité d'affiliation (0-1). Enregistrez l'URL sous Paramètres → Webhooks.
Webhook : alertes d'inclinaison
A tilt.alert Un événement se déclenche lorsqu'un joueur dépasse le seuil de tilt configuré, entraînant l'intervention recommandée (temps de recharge, avertissement de limite, suppression des bonus). Chaque alerte est consignée dans un journal d'audit via Compliance Guardian.
Configuration du webhook : postback
Pour renvoyer des signaux de qualité affiliée à votre outil de suivi, ajoutez son URL de postback sous Paramètres → Intégrations grâce à la fonction {click_id} et {quality_score} Les macros. NowG les déclenche de serveur à serveur chaque fois qu'un score de cohorte change de manière significative.