API розробника NowG

API NowG дозволяє транслювати поведінку гравців на платформу та отримувати результати моделі — когортні оцінки, сповіщення про нахил та сигнали якості партнерів — назад у вигляді вебхуків. Це API JSON/HTTPS; кожен запит обмежується одним клієнтом за допомогою його токена-носія. Базова URL-адреса: https://api.nowg.net/v1.

Authentication

Усі запити використовують токен-носій, обмежений одним клієнтом. Генеруйте та ротуйте ключі з панелі інструментів у розділі Налаштування → APIНадішліть це в Authorization заголовок: Authorization: Bearer $KEYКлючі обмежені середовищем (тестування / активність) і не мають терміну дії до ротації.

Обмеження ставок

Швидкість споживання обмежена 500 запитів/секунду на клієнта, з можливістю розширення до 1,000. Пакети враховуються як один запит. При обмеженні ви отримуєте 429 з Retry-After заголовок — відступити та повторити спробу; прийом ідемпотентний, тому повтори безпечні.

Події гравців

Транслюйте поведінкові події в режимі реального часу, щоб моделі могли оцінювати схильність до волатильності, ризик нахилу та якість когорти. Події дедуплікуються за допомогою event_id.

Пакетний імпорт

Історія заповнення шляхом POST-інгу масиву довжиною до Події 1,000 до /v1/players/events/batchВідповідь повертає для кожного елемента accepted та deduped рахується. Порядок не має значення — події мають часову мітку ts, а не прибуття.

Дедуплікація

Кожна подія несе в собі event_id ви контролюєте. NowG зберігає його протягом 30 днів; повторення протягом цього вікна мовчки ігнорується (враховується як deduped). Це робить повторні спроби, черги з виконанням хоча б одного разу та повторні відтворення повністю безпечними.

Вебхук: когортні оцінки

Коли модель перерахунку очок гравця завершує, NowG публікує cohort.scored подію на URL-адресу вашого вебхука з оцінками волатильності, ризику нахилу та якості партнерської програми (0–1). Зареєструйте URL-адресу під Налаштування → Вебхуки.

Вебхук: сповіщення про нахил

A tilt.alert Подія спрацьовує, коли гравець перетинає налаштований вами поріг нахилу, виконуючи рекомендоване втручання (перезарядка, запит на обмеження, відсутність бонусу). Кожне сповіщення реєструється для аудиту в системі Compliance Guardian.

Вебхук: налаштування постбек-постбеку

Щоб надсилати сигнали партнерської якості назад до вашого трекера, додайте його URL-адресу зворотного зв'язку в розділ Налаштування → Інтеграції з {click_id} та {quality_score} макроси. NowG запускає його між серверами щоразу, коли показник когорти суттєво змінюється.