ממשק API למפתחים של NowG

ממשק ה-API של NowG מאפשר לך להזרים התנהגות שחקנים לפלטפורמה ולקבל פלטי מודל - ציוני קבוצות, התראות הטיה ואותות איכות שותפים - בחזרה כ-webhooks. זהו ממשק API של JSON/HTTPS; כל בקשה מוגדרת לדייר יחיד על ידי אסימון הבעלים שלו. כתובת אתר בסיסית: https://api.nowg.net/v1.

אימות

כל הבקשות משתמשות באסימון נושא המיועד לדייר אחד. צור וסובב מפתחות מלוח המחוונים תחת הגדרות → APIשלח את זה ב- Authorization כּוֹתֶרֶת: Authorization: Bearer $KEYמפתחות הם בעלי טווח סביבתי (בדיקה / חיים) והם לעולם לא פגים עד שיעברו סיבוב.

מגבלות תעריפים

הבליעה מוגבלת בקצב ל- 500 בקשות/שנייה לכל דייר, ניתן לפריסה עד 1,000. קבוצות נחשבות כבקשה אחת. כאשר הן מוגבלות, אתה מקבל 429 עם Retry-After כותרת - חזור ונסה שוב; בליעה היא אידמפוטנטית, כך שההשמעות החוזרות בטוחות.

אירועי שחקנים

הזרמת אירועים התנהגותיים בזמן אמת כדי שהמודלים יוכלו לדרג את תיאבון התנודתיות, סיכון ההטיה ואיכות הקבוצות. אירועים מבוטלים על ידי event_id.

ייבוא ​​אצווה

היסטוריית מילוי חוזר על ידי POSTing מערך של עד אירועי 1,000 ל /v1/players/events/batchהתגובה מחזירה כל פריט accepted ו deduped ספירות. הסדר לא משנה - אירועים מקבלים חותמת זמן על ידי ts, לא הגעה.

מניעת כפילות

כל אירוע נושא עמו event_id אתה שולט. NowG מאחסן אותו למשך 30 יום; חזרה בתוך חלון זה מתעלמת בשקט (נספרת תחת dedupedזה הופך ניסיונות חוזרים, תורים של לפחות פעם אחת והשמעות חוזרות לבטוחים לחלוטין.

Webhook: ציוני קבוצות

כאשר מודל שמבצע שינוי ניקוד של שחקן מסתיים, NowG מפרסם cohort.scored אירוע לכתובת האתר של ה-webhook שלך עם ציוני תנודתיות, סיכון הטיה ואיכות שותפים (0-1). רשום את כתובת האתר תחת הגדרות → Webhooks.

Webhook: התראות הטיה

A tilt.alert אירוע מופעל כאשר שחקן חוצה את סף ההטיה שהוגדר לך, תוך ביצוע ההתערבות המומלצת (צינון, הנחיית הגבלה, ללא בונוס). כל התראה נרשמת לצורך ביקורת תחת Compliance Guardian.

Webhook: הגדרת פוסטבק

כדי להחזיר אותות איכות של שותפים למעקב שלך, הוסף את כתובת ה-URL שלו תחת הגדרות → אינטגרציות עם {click_id} ו {quality_score} פקודות מאקרו. NowG מפעילה אותו משרת לשרת בכל פעם שציון קבוצה משתנה באופן מהותי.