API pro vývojáře NowG

Rozhraní NowG API umožňuje streamovat chování hráčů do platformy a přijímat výstupy modelu – skóre kohort, upozornění na tilt a signály kvality affiliate partnerů – zpět jako webhooky. Jedná se o rozhraní JSON/HTTPS API; každý požadavek je omezen na jednoho tenanta pomocí jeho nosičského tokenu. Základní URL: https://api.nowg.net/v1.

Ověřování

Všechny požadavky používají nosičský token vymezený pro jednoho tenanta. Generujte a rotujte klíče z řídicího panelu v části Nastavení → APIPošlete to v Authorization záhlaví: Authorization: Bearer $KEYKlíče jsou omezeny na dané prostředí (testovací / aktivní) a jejich platnost nikdy nevyprší, dokud nebudou rotovány.

Sazbové limity

Příjem je omezen rychlostí 500 požadavků/sekundu na tenanta, rozšiřitelné na 1 000. Dávky se počítají jako jeden požadavek. Při omezení obdržíte 429 s Retry-After hlavička — ukončení a opakování; příjem je idempotentní, takže přehrání je bezpečné.

Události hráčů

Streamujte behaviorální události v reálném čase, aby modely mohly hodnotit volatilitu, riziko tiltu a kvalitu kohorty. Události jsou deduplikovány pomocí event_id.

Dávkový import

Historie zásypu odesláním pole až do 1,000 události na /v1/players/events/batchOdpověď vrací hodnotu pro každou položku. accepted a deduped počítá se. Na pořadí nezáleží – události jsou označeny časem ts, ne příjezd.

Deduplikace

Každá událost s sebou nese event_id máte kontrolu. NowG jej ukládá po dobu 30 dnů; opakování v tomto okně je tiše ignorováno (počítá se pod deduped). Díky tomu jsou opakované pokusy, fronty s alespoň jednou zařazením do fronty a přehrání zcela bezpečné.

Webhook: skóre kohorty

Když je přehodnocení hráče dokončeno modelem, NowG ZVEŘEJNÍ cohort.scored událost na URL adresu vašeho webhooku s hodnocením volatility, rizika tiltu a kvality affiliate partnerů (0–1). Zaregistrujte URL pod Nastavení → Webhooky.

Webhook: upozornění na náklon

A tilt.alert Událost se spustí, když hráč překročí vámi nakonfigurovaný práh tiltu, a provede doporučený zásah (přebíjecí doba, výzva k dosažení limitu, žádný bonus). Každé upozornění je zaznamenáno pro audit v rámci služby Compliance Guardian.

Webhook: nastavení postbacku

Chcete-li do svého trackeru vracet signály v affiliate kvalitě, přidejte jeho postback URL pod Nastavení → Integrace s {click_id} a {quality_score} makra. NowG jej spustí mezi servery vždy, když se skóre kohorty podstatně změní.