Πώς να συνδέσετε τους παρόχους μέσω API: χειραψία, πιστοποίηση, αμμοκιβώτιο

Πλήρες άρθρο

💡 18+. Το υλικό είναι μηχανικό και εφαρμόζεται, όχι κλήση για παιχνίδι. Με τον όρο «πάροχος» εννοούμε RGS/live studio/jackpot/service. στο πλαίσιο της «πλατφόρμας» - PAM/πορτοφόλι/ταμειακό γραφείο/πριμοδοτήσεις/RG.

1) Χάρτης ολοκλήρωσης: από την εφαρμογή στην παραγωγή

Στάδια:

1. Presale and Due Diligence: νομικοί έλεγχοι, geo/άδειες, συμβατότητα περιεχομένου και πολιτικές RG.

2. Χειραψία και ασφάλεια: έκδοση πρόσβασης σε αμμοκιβώτιο, ανταλλαγή κλειδιών (mTLS/HMAC), εγγραφή στο μητρώο Schema.

3. Τεχνικός σχεδιασμός: επιβεβαιώνουμε το μοντέλο τομέα (συνεδρίες/στοιχήματα/διακανονισμοί/γεγονότα), την ταυτότητα, τους κωδικούς σφάλματος.

4. Ενσωμάτωση Sandbox: προσομοιωτές πορτοφολιού/PSP/RG, δοκιμαστικοί παίκτες, βροχή και σενάρια λήψης.

5. Πιστοποίηση: υποχρεωτική εκτέλεση δοκιμών, υπογραφή πρωτοκόλλου, φορτία και περιπτώσεις χάους.

6. Στάθμευση/UAT: ρυθμίσεις μάχης χωρίς πραγματικό χρήμα, κίνηση καναρινιού.

7. Go-Live: βασική εταιρεία, επιτρέποντας σημαίες, παρακολούθηση SLO, ετοιμότητα μετά το συμβάν.

2) Χειραψία: εξακρίβωση ταυτότητας, εξουσιοδότηση, ιχνηλάτηση

2. 1 Κοινοχρησία μυστικών και πεδίων εφαρμογής

mTLS (ανά εμπορικό σήμα/περιφερειακό πιστοποιητικό) ή/και Client Certentials OAuth2.

HMAC/EdDSA ζητά υπογραφή φορέα (προσθέτει μη αποκήρυξη).

:: 'sessions: write', 'bets: write', 'settlements: write', 'events: publish'.

2. 2 Υποχρεωτικές επικεφαλίδες

"X-Trace-I - ιχνηλάτηση από άκρο σε άκρο.

«X-Brand-I ,» X-Region «,» X-Provider-I .

«X-Idempotency-Key» - για όλες τις πράξεις εγγραφής.

2. Έλεγχος υγείας (πριν από τον κωδικό)


GET/Υγεία
200 {"status ": "ok"," version":" 1. 7. 2 ", "χρόνος":" 2025-10-23T10: 00: 00Z"}

3) Sandbox: τι υπάρχει και πώς χρησιμοποιείται

Περιβαλλοντική σύνθεση:

Προσομοιωτής πορτοφολιού ('/πορτοφόλι/χρέωση	πίστωση	rollback ') με ιδιαιτερότητα και καθυστερήσεις.
Αγκίστρια RG ('/rg/check ',' rg. όριο. hit ') και προφίλ δοκιμής (αυτοαποκλεισμός/όρια).
Ψεύτικος συλλέκτης/τζάκποτ για συνεισφορές/σκανδάλες.
Ψεύτικες απαντήσεις KYC/AML (επιτρέπουν/αρνούνται/εκκρεμούν).
Λεωφορείο εκδήλωσης (Kafka/Pulsar) με θέματα δοκιμής και μητρώο Schema.

Αρμονία με την πραγματικότητα:

Παρόμοιες εκδόσεις συστημάτων και όρια επιτοκίων όπως στην πώληση.
Time-sky, doubles παράδοσης, out-of-order - ενσωματωμένα κουμπιά εξομοίωσης.

Σύνολο δοκιμαστών/νομισμάτων:


(EUR),  (USD),  (απορρίπτεται),

4) Πρότυπο πόρων και ελάχιστη σύμβαση

4. Δημιουργία 1 συνεδρίας


POST/v1/συνεδριάσεις
{
«player_id":"p_demo_1,» «game_id":"studio:slot_forge_02,» «νόμισμα»:» EUR», «locale»:» de-DE»
}
201 {«session _ i :» s _ 456 «,» expires _ a : «2025-10-23T19: 10: 00Z»}

4. 2 Έγκριση επιτοκίου (κύτος)


POST/v1/στοιχήματα/εξουσιοδότηση
Κεφαλίδες: X-Idempotency-Key: bet_r_8c12_1
{
"session_id":"s_456," "bet_id":"b_001," round_id":"r_8c12, "" ποσό ": {" ποσό ": 2. 00, «νόμισμα»:» EUR»}
}
200 {"status": "εξουσιοδοτημένος", "hold _ i →:" h _ zz1 "}

4. 3 Διακανονισμός (στρογγυλή έκβαση)


POST/v1/στοιχήματα/διακανονισμός
Κεφαλίδες: X-Idempotency-Key: settle_r_8c12_1
{
"bet_id":"b_001," "round_id":"r_8c12," win ": {" ποσό ": 14. 60, "νόμισμα":" EUR"}, "bonus_state":{"in_bonus":true,"freespins_left":7}
}
200 {"status": "credited", "settlement _ i →:" st _ 77 "}

4. 4 Σφάλματα (ενιαίο διάγραμμα)


409
{«code «: «DUPLICATE»,» message»:» Bet ήδη εγκεκριμένο «, «retryable «: false,» trace _ id»:» tr _ a1b2»}

5) Γεγονότα και συστήματα: χωρίς αυτό δεν θα περάσετε την πιστοποίηση

Βασικά θέματα:

'session. Έναρξη λειτουργίας	τέλος ',' στοίχημα. εγκεκριμένη	διακανονισμός	, 'μπόνους. εκδοθέν	καταναλωθέν ',' στοίχημα. την πρόοδο. ενημερωμένο πορτοφόλι ','. χρεωστική. ',' πορτοφόλι. πίστωση «.,» rg. όριο. χτύπημα ',' rg. .

Παράδειγμα Avro/JSON Schema (θραύσμα 'bet. διακανονισμός "):

json
{
"event_type":"bet. "", "schema_version":"1. 2. 0 «,» event_id":"uuid, «» occurred_at":"2025-10-23T16:21:05Z, «» tenant_id":"brand-7, «» περιοχή «:» EU «,» player_id":"p_demo_1, «trace_id":"tr_a1b2,» «ωφέλιμο φορτίο»: {
«round_id":"r_8c12,» «στοίχημα «: {«ποσό»: 1. 00, «νόμισμα»:» EUR»}, «win «: {«ποσό»: 14. 60, "νόμισμα":" EUR"}, "in_bonus":true
}, «idempotency_key":"bet_r_8c12_1»
}

Κανόνες: προς τα πίσω συμβατή εξέλιξη, δοκιμή για «αντίγραφα και καθυστερημένα γεγονότα», συμμετοχή του «ενοικιαστή _ id/player _ id».

6) Πιστοποίηση ένταξης: τι ακριβώς ελέγχεται

6. 1 Λειτουργικά σενάρια (ελάχιστο)

Επαναδοκιμάστε το αίτημα 'authorize/settle' με το ίδιο 'X-Idempotency-Key' → την ίδια απάντηση.

Εκτός τάξης: «διακανονισμός» ήρθε χωρίς «εξουσιοδότηση» → σωστή αποτυχία.

Αλυσίδες ανατροπής όταν πέφτει το πορτοφόλι/δίκτυο.

Στάσεις RG: όριο αυτοαποκλεισμού/απώλειας/χρόνος → απαγόρευση στοιχήματος.

Bonus/vager: συνεισφορά ανά τύπο παιχνιδιού, μέγιστο στοίχημα, προθεσμίες.

6. 2 Φορτίο

p95 'στοίχημα/διακανονισμός' στους προϋπολογισμούς (π.χ. «<200-300 ms»), δεν υπάρχουν «καταιγίδες» από ρετιρέ.

Οι ροές γεγονότων φτάνουν τα BI ≤ 5 λεπτά.

6. 3 Περιπτώσεις χάους

Διπλά παράδοσης, καθυστερήσεις εξόδου/ΚΕΕΛΠΝΟ, χωματερή, μερικός διακανονισμός.

6. 4 Παραδοτέα

Πρωτόκολλο δοκιμής με χρονοδιαγράμματα/ιχνοστοιχεία.

Έκθεση SLO (καθυστέρηση/σφάλμα/υστέρηση).

Περίληψη ασφαλείας (κλειδιά, περιστροφές, προσβάσεις, θησαυροφυλάκιο/HSM).

7) Έκδοση και μετανάστευση

HTTP: '/v1/... "σε διαμετακόμιση, γεγονότα:" schema _ version "στο σώμα.

SemVer: ήσσονος σημασίας - προσθήκη προαιρετικών πεδίων· - µόνο µέσω του νέου προθέµατος «/v2/».

Κεφαλίδες υποτίμησης: 'Απερήμωση', 'Ηλιοβασίλεμα', ταμπλό χρησιμοποιούν καθρέφτη.

Σημαίες: το «διπλό γράμμα» των γεγονότων ('v1' και 'v2') σε μεταβατικό στάδιο.

8) Ασφάλεια και συμμόρφωση

mTLS + S2S υπογραφές, βραχύβιες μάρκες, οριοθετημένα πεδία εφαρμογής.

Μηδενική εμπιστοσύνη: πολιτικές δικτύου, κλειδιά ανά εμπορικό σήμα/περιφέρεια.

Κατοικία δεδομένων & PII: αποθήκευση και καταγραφή στην περιοχή· RLS/κάλυψη.

Έλεγχος WORM: αλλαγές στα όρια, προφίλ RTP, ρυθμίσεις τζάκποτ.

RG/AML: σύγχρονα φώτα στοίβαξης/πληρωμής· Αναφορά SAR/STR.

9) Έξοδος από την παραγωγή: κατάλογος ελέγχου εκτόξευσης

Προτού ενεργοποιηθεί η κυκλοφορία

Περιστροφή μυστικών αμμοκιβωτίων → πλήκτρων.

Συμπεριλαμβάνονται τα ταμπλό p95/p99, ο ρυθμός σφάλματος, η καθυστέρηση αναμονής, η καθυστέρηση εγκατάστασης.

Ειδοποίηση SLO: παραβίαση λόγω καθυστέρησης/σφάλματος/καθυστέρησης, κύμα 'DUPLICATE/IDEMPOTENCY _ MISMATCH'.

Σχέδιο DR: RPO ≤ 5 λεπτά, RTO ≤ 30 λεπτά· «κόκκινο κουμπί» - σταματήστε τις νέες συνεδρίες.

Καναρίνια

1-5% ακροατήριο/παιχνίδια/geo; αυτόματη ανατροπή σε περίπτωση παραβίασης SLO.

Μετά την παρακολούθηση 24-72 ώρες, λογιστική αντιστοίχιση/αναφορά.

10) Αντι-μοτίβα (κόκκινες σημαίες)

Εκδοτικές εκδηλώσεις που παρακάμπτουν το outbox/CDC.

Απουσία του 'X-Idempotency-Key' σε πράξεις εγγραφής.

Χειροκίνητες επεξεργασίες υπολοίπων/διακανονισμών στη βάση δεδομένων.

Μονά κλειδιά για πολλαπλές μάρκες/περιφέρειες.

Οι BI και οι κανονιστικές εκθέσεις προστίθενται στη βάση δεδομένων OLTP για την καταπολέμηση.

Μηδενική υποβάθμιση: η πτώση του παρόχου κατεβάζει το πορτοφόλι/πλατφόρμα.

11) Κατάλογοι ελέγχου

Για τον πάροχο

Πάντα στέλνω το «X-Trace-Id» και το «X-Idempotency-Key».

Υποστηρίζω την επανάληψη με το ίδιο κλειδί χωρίς παρενέργειες.

Δημοσίευση συμβάντων σχήματος από το μητρώο. αποθηκεύει 'schema _ version'.
Εφαρμόζονται τα εφεδρικά τρένα και η αποπάγωση.

Οι στάσεις RG και τα όρια πριμοδότησης εφαρμόζονται σε πραγματικό χρόνο.

Πρόσβαση και μυστικά - ανά εμπορικό σήμα/περιοχή, διαμόρφωση περιστροφής.

Για πλατφόρμα

Outbox/CDC σε όλες τις χρηματικές διαδρομές, ιχνηλάτηση από άκρο σε άκρο.
Ταμπλό SLO: p95/99, ποσοστό σφάλματος, καθυστέρηση αναμονής, καθυστέρηση καθίζησης.
Διαδικασία απερήμωσης/ηλιοβασίλεμα, διπλή επιστολή γεγονότων για τις μεταναστεύσεις.
ασκήσεις DR/xaoc, διαχείριση συμβάντων και νεκροψίες.
Τρόποι υποβάθμισης: «όχι νέες συνεδρίες», απενεργοποίηση promo/τζάκποτ.

12) Παράδειγμα ενός «ελάχιστου» playbook ενσωμάτωσης (TL; DR)

1. Υπογραφή NDA/σύμβασης → έκδοση πρόσβασης και συστημάτων αμμοκιβωτίων.

2. τα πιστοποιητικά ανταλλαγής mTLS/HMAC· έναρξη 'provider _ i .

3. Συμφωνήστε σε ελάχιστα τελικά σημεία: «σύνοδοι», «στοιχήματα/εξουσιοδότηση», «στοιχήματα/διακανονισμός», «rollback».

4. Σύνδεση με το λεωφορείο και το μητρώο Sandbox. να εκδιώξει λειτουργικές περιπτώσεις/περιπτώσεις χάους.

5. Επιτυχία του πρωτοκόλλου πιστοποίησης: logs, trace-id, SLO report.

6. Αλλάξτε τα κλειδιά στο φαγητό, ενεργοποιήστε το καναρίνι, παρατηρήστε SLO.

7. Καταγραφή μετρήσεων μετά την κυκλοφορία και «μαθημάτων» σε changelog.

Η επιτυχής σύνδεση του παρόχου δεν είναι μόνο μια API, αλλά και μια ελεγχόμενη διαδικασία: μια ασφαλής χειραψία, ένα ρεαλιστικό κουτί άμμου, αυστηρή πιστοποίηση, παρατηρησιμότητα και σαφείς κανόνες συμβατότητας. Ακολουθώντας τις περιγραφόμενες αναλλοίωτες (idempotency, outbox/CDC, RG/AML stops, SLO και DR), επιταχύνεις την ολοκλήρωση, αποφεύγεις νομισματικά συμβάντα και παίρνεις προβλέψιμες κυκλοφορίες - χωρίς εκπλήξεις για τους παίκτες, τις ρυθμιστικές αρχές και τις επιχειρήσεις.