NowG開発者API

NowG APIを使用すると、プレイヤーの行動をプラットフォームにストリーミングし、モデルの出力（コホートスコア、傾斜アラート、アフィリエイト品質シグナルなど）をWebhookとして受信できます。これはJSON/HTTPS APIであり、すべてのリクエストはベアラートークンによって単一のテナントにスコープされます。ベースURL： https://api.nowg.net/v1.

認証

すべてのリクエストは、1 つのテナントにスコープされたベアラートークンを使用します。ダッシュボードからキーを生成およびローテーションします。 設定 → API. 送ってください Authorization ヘッダ： Authorization: Bearer $KEYキーは環境（テスト環境／本番環境）ごとにスコープが異なり、ローテーションされるまで有効期限が切れることはありません。

レート制限

摂取速度は 500件のリクエスト/秒 テナントごとに、最大1,000までバースト可能。バッチは1つのリクエストとしてカウントされます。スロットリングされると、次のようになります。 429 また、 Retry-After ヘッダー — 一旦停止して再試行します。取り込みは冪等性を持つため、リプレイは安全です。

プレイヤーイベント

リアルタイムの行動イベントをストリーミングして、モデルがボラティリティ許容度、傾斜リスク、コホート品質をスコアリングできるようにします。イベントは、 event_id.

一括インポート

履歴をバックフィルするには、最大で配列を POST します。 1,000イベント 〜へ /v1/players/events/batch応答はアイテムごとに返されます accepted (NAIST) と deduped カウントします。順序は関係ありません。イベントにはタイムスタンプが付けられます。 ts到着ではなく、

重複排除

すべてのイベントには event_id あなたがコントロールします。NowGはそれを30日間保存します。その期間内の繰り返しは黙って無視されます（ dedupedこれにより、再試行、少なくとも1回キュー、およびリプレイが完全に安全になります。

ウェブフック：コホートスコア

モデルがプレイヤーを再採点し完了すると、NowG は POST します。 cohort.scored 変動性、傾斜リスク、アフィリエイト品質スコア（0～1）を含むイベントをウェブフックURLに登録します。 設定 → Webhooks.

Webhook: 傾斜アラート

A tilt.alert プレイヤーが設定した傾き閾値を超えるとイベントが発生し、推奨される介入策（クールダウン、制限プロンプト、ボーナスなし）が実行されます。すべてのアラートは、コンプライアンスガーディアンによる監査のためにログに記録されます。

Webhook: ポストバック設定

アフィリエイト品質のシグナルをトラッカーにフィードバックするには、そのポストバック URL を以下に追加します。 設定 → 統合 {click_id} (NAIST) と {quality_score} マクロ。NowGは、コホートスコアが大幅に変化するたびに、サーバー間でこのマクロを実行します。