איך לחבר ספקים באמצעות API: לחיצת יד, אישור, ארגז חול

מאמר מלא

💡 18+. החומר הוא הנדסי ומיושם, לא קריאה לשחק. על ידי ”ספק” אנחנו מתכוונים RGS/live studio/זכייה/שירות; מתחת ל ”פלטפורמה” - PAM/ארנק/שולחן מזומן/בונוסים/RG.

1) מפת אינטגרציה: מיישום לייצור

שלבים:

1. בדיקות משפטיות, רישיונות גיאו, תאימות תוכן ומדיניות אר ג 'י.

2. לחיצת יד ואבטחה: הנפקת נגישות לארגז חול, החלפת מפתחות (mTLS/HMAC), רישום עם סכימה.

3. תכנון טכני: אנו מאשרים את מודל התחום (הפעלות/הימורים/יישובים/אירועים), אידמפוטנטיות, קודי שגיאה.

4. שילוב ארגז חול: ארנק/PSP/RG אמולטורים, שחקני מבחן, גשם ולקחת תרחישים.

5. ריצת מבחן חובה, חתימת פרוטוקולים, עומס ומקרי כאוס.

6. הגדרות לחימה ללא כסף אמיתי, תנועה כנרית.

7. Go-Live: חברת מפתח, מתן דגלי תכונה, מעקב SLO, מוכנות לאחר אירוע.

2) לחיצת יד: אימות, אישור, איתור

2. 1 שיתוף סודות וסקופים

MTLS (לכל תעודות מותג/אזור) ו/או OAuth2 תעודות לקוח.

HMAC/EDDSA מבקש חתימת גוף (מוסיף אי-חידוש).

”מפגשים: לכתוב”, ”הימורים: לכתוב”, ”התנחלויות: לכתוב”, ”אירועים: לפרסם”.

2. 2 כותרות חובה

איתור מקצה לקצה.

”X-Brand-Id',” X-Region ”,” X-ספק-Id'.

מפתח אידמפוטנטי לכל פעולות הכתיבה.

2. 3 בדיקת בריאות (לפני קוד)


גט/בריאות
# 200 "סטטוס ": "אוקי"," גרסה":" 1. 7. 2, ”זמן”: ”2025-10-23T10: 00-00Z”

3) ארגז חול: מה יש ואיך להשתמש בו

הרכב סביבתי:

הדמיית ארנק ('/ארנק/חיוב	אשראי	) עם אידמפוטנטיות ועיכובים.
קרסים של RG ('/rg/check ',' rg. הגבלה. חבטה) ופרופילי מבחן (הדרה עצמית/גבולות).
אגרגטור/זכייה כוזבת לתרומות/טריגרים.
תגובות מזויפות של KYC/AML (אפשר/מכחיש/תלוי ועומד).
אוטובוס אירועים (Kafka/Pulsar) עם נושאי מבחן ורישום סכמות.

הרמוניה עם המציאות:

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

סט של שחקנים/מטבעות מבחן:


 (EUR),  (USD),

4) מודל משאבים וחוזה מינימלי

4. יצירת הפעלה 1


פוסט/v1/מפגשים
{
”player_id":"p_demo_1,” ”game_id":"studio:slot_forge_02,” ”מטבע”:” EUR”, ”locale”:” דה דה”
}
# 201 ”session _ id':” s _ 456 ”,” פג _ at': ”2025-10-23T19: 10: 00Z”

4. אישור קצב 2 (החזק)


פוסט/v1/הימורים/לאשר
כותרות: X-Idempotency-Key: bet_r_8c12_1
{
”session_id":"s_456,” ”bet_id":"b_001,” ”round_id":"r_8c12,” ”כמות”: 00, ”מטבע”:” EUR”
}
* 200 "סטטוס": "מורשה", "hold _ id':" h _ zz1 "

4. 3 הסדר (תוצאה עגולה)


פוסט/v1/הימורים/להתיישב
כותרות: X-Idempotency-Key: settle_r_8c12_1
{
”bet_id":"b_001,” ”round_id":"r_8c12,” ”לנצח ”: [”כמות”: 14. 60, ”מטבע”: ”EUR”, ”bonus_state":{"in_bonus":true,"freespins_left":7”
}
# 200 "סטטוס": "קרדיט", "הסדר _ id':" st _ 77 "

4. 4 שגיאות (תרשים יחיד)


409
"קוד": "DUPLICATE", "הודעה": "בית כבר מורשה", "trace _ id':" tr _ a1b2 "

5) אירועים ומזימות: בלי זה לא תעבור הסמכה

נושאים בסיסיים:

'Session. התחיל	נגמר, 'הימור. מורשה	פשרה	rolled_back', בונוס. הונפקה	נצרך, 'הימור. התקדמות. מעודכן, ארנק. חיוב. ", ארנק. קרדיט. ',' rg. הגבלה. פגע ',' rg. reality_check'.

דוגמה Avro/JSON Schema (שבר 'bet. התיישב):

ג 'סון
{
"event_type":"bet. התיישב,” ”schema_version":"1. 2. 0, ” ”  ” ”  ”אזור”:
”round_id":"r_8c12,” ”הימור ”: [”כמות”: 1. 00, ”מטבע”: ”EUR”, ”לנצח”: [”סכום”: 14. 60, ”מטבע”: ”EUR”? ”,” in_bonus":true
”idempotency_key":"bet_r_8c12_1”
}

כללים: אבולוציה תואמת לאחור, מבחן עבור "שכפולים ואירועים מאוחרים", השתתפות של "terenant _ id/player _ id'.

6) הסמכת אינטגרציה: מה בדיוק נבדק

6. 1 תרחישים פונקציונליים (מינימום)

נסה שוב את בקשת האישור/הסדר עם אותו מפתח X-Idempotency = = אותה תגובה.

Out-off-off: ”להתיישב” בא בלי ”אישור” = כשל נכון.

שרשראות Rollback כאשר הארנק/רשת נופלת.

RG מפסיק: הרחקה עצמית/הגבלת אובדן/זמן = = איסור הימור.

בונוס/ואגר: תרומה לפי סוג המשחק, הימור מקסימלי, מועדים.

6. 2 טעינה

p95 'הימור/להתיישב' בתקציבים (למשל '<200-300 ms'), אין ”סערות” של מגשים מחדש.

זרמי אירוע להגיע BI 5 דקות.

6. 3 מקרי כאוס

מכפילי משלוחים, עיכובים במב "מ, איזור" מזבלה ", הסדר חלקי.

6. 4 מצילים

פרוטוקול בדיקה עם timecodes/trace-id.

דו "ח SLO (latency/image/lag).

סיכום אבטחה (מפתחות, סיבובים, גישה, כספת/HSM).

7) גרסה ונדידה

HTTP: '/v1/... 'במעבר, אירועים:' סכימה _ גרסה 'בגוף.

SemVer: שדות אופציונליים להוספת מינור; רס "ן - רק דרך הקידומת החדשה 'v2/'.

כותרות הפחתה: ”Deprecation”, ”Sunset”, לוח מחוונים להשתמש במראה.

דגלים: ”אות כפולה” של אירועים (”v1” ו- ”v2”) במעבר.

8) בטיחות וציות

חתימות של MTLS + S2S, אסימונים קצרי ימים, סקופים מחוברים.

אפס אמון: מדיניות רשת, מפתחות לכל מותג/אזור.

התמחות נתונים & PII: אחסון ויומנים באזור; RLS/מיסוך.

ביקורת תולעת: שינויים לגבולות, פרופילי RTP, תצורות קופה.

RG/AML: מנורות עצירה סינכרוניות בהימור/תשלום; דיווח SAR/STR.

9) יציאה לייצור: רשימת שיגור

לפני שהתנועה מופעלת

סיבוב של סודות ארגז חול = מפתחות פרוד.

כולל לוחות מחוונים p95/p99, קצב שגיאה, תור-לג, ליישב-לג.

התראה SLO: פריצה על ידי LATENCY/שגיאה/LAG, SURGE 'DUPLICATE/IDEMPOTENCY _ MISMATCH'.

RPO, 5 דקות, RTO 30 דקות; ”כפתור אדום” - להפסיק מפגשים חדשים.

קנרית

1-5% קהל/משחקים/גיאו; החזרה אוטומטית במקרה של הפרת SLO.

לאחר ניטור 24-72 שעות, פנקס/דיווח פיוס.

10) אנטי דפוסים (דגלים אדומים)

פרסום אירועים עוקף תיבה/CDC.

היעדר 'X-Idempotency-Key' על פעולות כתיבה.

עריכה ידנית של מאזן/התנחלויות במאגר הנתונים.

מפתחות בודדים למותגים/אזורים מרובים.

דו "חות BI ורגולציה על גבי מסד נתוני קרב OLTP.

אפס הידרדרות: נפילת הספק מורידה את הארנק/פלטפורמה.

11) רשימות בדיקה

עבור הספק

[ ] אני תמיד שולח "X-Trace-Id' ו-" X-Idempotency-Key ".

[ ] אני תומך חוזר עם אותו מפתח ללא תופעות לוואי.

תרשים Publish schema from Registry; חנות 'shema _ גרסה'.

[ ] Backoff Retrains ו Dauplication מיושמים.

[ ] אר ג 'י עוצרות ומגבלות בונוס נאכפות בזמן אמת.

[ גישה ] וסודות - לכל מותג/אזור, סיבוב מוגדר.

עבור פלטפורמה

[ ] Outbox/CDC בכל נתיבי הכסף; איתור מקצה לקצה.

[ ] לוחות מחוונים: p95/99, שיעור שגיאות, תור-לג, ליישב-לג.

[ תהליך ]/שקיעה, אות כפולה של אירועים על נדידה.

[ ] תרגילי DR/xaoc, ניהול אירוע ולאחר המוות.

[ ] מצבי הידרדרות: 'אין מפגשים חדשים', בטל את הפרומו/כל הקופה.

12) דוגמה לספר משחקים אינטגרטיבי ”מינימלי” (TL; DR)

1. חתום על הסכם אי-די-איי/חוזה.

2. החלפת תעודות mTLS/HMAC; מתחיל 'provider _ id'.

3. מסכים על נקודות קצה מינימליות: ”הפעלות”, ”הימורים/אישור”, ”הימורים/הסדר”, ”rollback”.

4. התחבר לאוטובוס וארגז החול; לגרש מקרים פונקציונליים/כאוס.

5. העבר את פרוטוקול ההסמכה: יומנים, איתור, דו "ח SLO.

6. להחליף מפתחות למזון, להדליק את הקנרית, להתבונן SLO.

7. מדדים שלאחר שחרור הקלטות ו ”שיעורים” בצ 'אנצ' לוג.

חיבור מוצלח של הספק הוא לא רק API, אלא תהליך מבוקר: לחיצת יד בטוחה, ארגז חול מציאותי, הסמכה קפדנית, יכולת תצפית וכללי תאימות ברורים. על ידי הפעלת האינווריאנטים המתוארים (idempotency, outbox/CDC, RG/AML stop, SLO ו-DR), אתה מאיץ אינטגרציות, נמנע מתקריות מוניטריות ומקבל שחרור צפוי - ללא הפתעות לשחקנים, רגולטורים ועסקים.