Dokumenty/API pre vývojárov

API pre vývojárov NowG

Rozhranie NowG API vám umožňuje streamovať správanie hráčov do platformy a prijímať výstupy modelu – skóre kohort, upozornenia na tilt a signály kvality affiliate partnerov – späť ako webhooky. Ide o rozhranie JSON/HTTPS API; každá požiadavka je viazaná na jedného nájomníka podľa jeho tokenu nosiča. Základná URL adresa: https://api.nowg.net/v1.

Overovanie

Všetky požiadavky používajú token nosiča viazaný na jedného nájomníka. Generujte a rotujte kľúče z ovládacieho panela v časti Nastavenia → APIPošlite to v Authorization hlavička: Authorization: Bearer $KEYKľúče sú obmedzené na prostredie (testovacie / aktívne) a ich platnosť nikdy nevyprší, kým sa nerotujú.

Sadzobné limity

Príjem je obmedzený rýchlosťou 500 požiadavky/sekundu na nájomníka, rozložiteľné na 1 000. Dávky sa počítajú ako jedna požiadavka. Pri obmedzení dostanete 429 s Retry-After hlavička — ukončenie a pokus znova; príjem je idempotentný, takže opakované prehratia sú bezpečné.

Udalosti hráčov

POST/v1/hráči/udalosti

Streamujte behaviorálne udalosti v reálnom čase, aby modely mohli hodnotiť ochotu volatility, riziko tiltu a kvalitu kohorty. Udalosti sú deduplikované pomocou event_id.

id_hráčov
reťazec · povinný
Váš PAM identifikátor pre hráča.
event_id
reťazec · povinný
Kľúč idempotentnosti; duplicitné identifikátory sa ignorujú.
typ
výčet · povinné
vklad | stávka | výber | relácia | bonus_uplatniť.
čiastka
číslo
Hodnota v mene účtu, ak je to relevantné.
ts
reťazec · ISO-8601
Časová pečiatka udalosti v UTC.

Dávkový import

História zásypov odoslaním poľa s maximálnou dĺžkou udalosti 1,000 na /v1/players/events/batchOdpoveď vráti pre každú položku accepted a deduped počíta sa. Poradie nezáleží – udalosti sú časovo označené ts, nie príchod.

Deduplikácia

Každá udalosť so sebou nesie event_id máte kontrolu. NowG ho uchováva 30 dní; opakovanie v rámci tohto okna sa ticho ignoruje (započítava sa pod deduped). Vďaka tomu sú opakované pokusy, zaradenie do frontu s minimálne jedným pokusom a prehratia úplne bezpečné.

Webhook: skóre kohorty

Keď model prehodnocuje hráča, NowG ZVEREJNÍ cohort.scored udalosť na URL adresu vášho webhooku s hodnotením volatility, rizika tiltu a kvality affiliate partnerov (0–1). Zaregistrujte URL adresu pod Nastavenia → Webhooky.

Webhook: upozornenia na naklonenie

A tilt.alert Udalosť sa spustí, keď hráč prekročí vami nakonfigurovaný prah tiltu a vykoná odporúčaný zásah (doba opätovného získania bonusu, výzva na dosiahnutie limitu, žiadny bonus). Každé upozornenie sa zaznamená na účely auditu v rámci služby Compliance Guardian.

Webhook: nastavenie postbacku

Ak chcete do sledovacieho nástroja posielať signály v affiliate kvalite, pridajte jeho URL adresu pre spätné odkazy pod Nastavenia → Integrácie s {click_id} a {quality_score} makrá. NowG ho spúšťa medzi servermi vždy, keď sa skóre kohorty podstatne zmení.

Uprednostňujete podrobnú pomoc?
Sprievodcovia úlohami sú k dispozícii v Centre pomoci.
Centrum pomoci →
Požiadajte o ukážku
KROK 1 Z 3
Ďakujem – ste v rade.
Inžinier riešení spoločnosti NowG sa s vami spojí do jedného pracovného dňa a naplánuje si prehliadku.