Interfejs API dla programistów NowG

Interfejs API NowG umożliwia strumieniowe przesyłanie zachowań graczy na platformę i odbieranie wyników modelu – wyników kohort, alertów o przechyle i sygnałów jakości afiliacyjnej – w postaci webhooków. Jest to interfejs API JSON/HTTPS; każde żądanie jest ograniczone do pojedynczego najemcy na podstawie jego tokenu nośnika. Podstawowy adres URL: https://api.nowg.net/v1.

Uwierzytelnianie

Wszystkie żądania wykorzystują token nośnika o zakresie jednego dzierżawcy. Generuj i rotuj klucze z poziomu pulpitu nawigacyjnego. Ustawienia → API. Wyślij to w Authorization nagłówek: Authorization: Bearer $KEYKlucze mają zakres środowiskowy (testowy/na żywo) i nie wygasają do momentu przeprowadzenia rotacji.

Limity stawek

Połknięcie jest ograniczone szybkością 500 żądania/sekundę na najemcę, z możliwością rozszerzenia do 1,000. Partie liczą się jako jedno żądanie. Po ograniczeniu otrzymujesz 429 przy Retry-After nagłówek — wycofaj się i spróbuj ponownie; przetwarzanie jest idempotentne, więc powtórki są bezpieczne.

Wydarzenia gracza

Transmituj zdarzenia behawioralne w czasie rzeczywistym, aby modele mogły oceniać apetyt na zmienność, ryzyko przechylenia i jakość kohorty. Zdarzenia są deduplikowane przez event_id.

Import partii

Uzupełnij historię, wysyłając tablicę zawierającą do Wydarzenia 1,000 do /v1/players/events/batch. Odpowiedź jest zwracana dla każdego elementu accepted oraz deduped liczy się. Kolejność nie ma znaczenia — wydarzenia są oznaczane znacznikiem czasu ts, nie przybycie.

Deduplikacja

Każde wydarzenie niesie ze sobą event_id kontrolujesz. NowG przechowuje je przez 30 dni; powtórzenie w tym okresie jest ignorowane (liczone poniżej) deduped). Dzięki temu ponowne próby, kolejkowanie przynajmniej raz i odtwarzanie są całkowicie bezpieczne.

Webhook: wyniki kohort

Gdy model ponownego punktowania gracza zostanie ukończony, NowG wysyła cohort.scored zdarzenie do adresu URL swojego webhooka z wynikami zmienności, ryzyka przechyłu i jakości afilianta (0–1). Zarejestruj adres URL w Ustawienia → Webhooki.

Webhook: alerty przechyłu

A tilt.alert Zdarzenie jest aktywowane, gdy gracz przekroczy skonfigurowany próg tiltu, powodując zalecaną interwencję (czas odnowienia, monit o limit, brak bonusu). Każdy alert jest rejestrowany w celu przeprowadzenia audytu w ramach Compliance Guardian.

Webhook: konfiguracja postbacku

Aby przesłać sygnały o jakości partnerskiej do swojego modułu śledzącego, dodaj jego adres URL postback w polu Ustawienia → Integracje z {click_id} oraz {quality_score} Makra. NowG uruchamia je między serwerami za każdym razem, gdy wynik kohorty ulegnie istotnej zmianie.