NowG 개발자 API

NowG API를 사용하면 플레이어 행동 데이터를 플랫폼으로 스트리밍하고 코호트 점수, 틸트 알림, 제휴 품질 신호 등의 모델 출력값을 웹훅으로 수신할 수 있습니다. 이 API는 JSON/HTTPS 형식이며, 모든 요청은 베어러 토큰을 통해 단일 테넌트로 제한됩니다. 기본 URL: https://api.nowg.net/v1.

인증

모든 요청은 하나의 테넌트에 한정된 베어러 토큰을 사용합니다. 대시보드에서 키를 생성하고 갱신하세요. 설정 → 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 변동성, 틸트 리스크 및 제휴 품질 점수(0~1)를 사용하여 웹훅 URL에 이벤트를 전송합니다. 해당 URL을 등록하세요. 설정 → 웹훅.

웹훅: 기울기 알림

A tilt.alert 플레이어가 설정된 틸트 임계값을 넘어서면 이벤트가 발생하며, 권장되는 조치(쿨다운, 리미트 알림, 보너스 없음)가 적용됩니다. 모든 알림은 규정 준수 관리 시스템(Compliance Guardian)에서 감사 목적으로 기록됩니다.

웹훅: 포스트백 설정

제휴 품질 신호를 트래커에 다시 전송하려면 포스트백 URL을 아래에 추가하세요. 설정 → 통합 와 더불어 {click_id} {quality_score} 매크로. NowG는 코호트 점수가 크게 변경될 때마다 서버 간에 이를 실행합니다.