Protocolli comuni di interazione

1) Perché l'ecosistema ha protocolli uniformi

L'ecosistema è composto da operatori, studi/RGS, aggregatori, PSP/APM, KYC/AML provider, affiliati e servizi di analisi. I protocolli generali di interazione escludono le integrazioni dello zoo, accelerano l'onboard, riducono i costi di supporto e i rischi di incidenti, e garantiscono la compatibilità con la scalabilità (orizzontale, verticale e diagonale).

Obiettivi: compatibilità da scatola, SLO prevedibile, sicurezza dei dati, migrazioni riproducibili.

2) Livello di trasporto e formati

HTTP/2/3, gRPC per API sincrono a bassa latenza WebSocket - per eventi in streaming/liderboard; WebRTC (SRTP/QUIC) - per i contenuti audio/video live.

• JSON - API B2B esterne e webhoop (leggibilità).
• Protobuf/Avro è un pneumatico interno/integrazione profonda (compressione/evoluzione degli schemi).
• Compressione/binding: gzip/br per JSON; zstd per Protobuf/Avro.
• Locale/ora: ISO-8601 in UTC, importi in minime unità di cassa (integer).

3) Autenticazione, autorizzazione, fiducia

OAUTh2/OIDC per applicazioni client/partner (short-lived token, PKCE, scopes).
mTLS per S2S tra zone affidabili JWS/HMAC - Firma richieste e webhoop.
RBAC/ABAC: ruoli e attributi (giurisdizione, tenant, rischio-livello).
Chiavi e rotazione: KMS/Vault, vita breve, rotazione automatica (JWKS).
Egress Control, allow-list domini e ASN, DNSSEC/DoT/DoH in zone sensibili.
Tenant isolation: chiavi per-tenant, quote, limiti, namespace-e nel pneumatico.

4) Contratti API (REST/gRPC) - canonica

Versioning: '/v {n} 'in URI per REST'package. vN per il gRPC. L'evoluzione minor è priva di frantumi; modifiche breaking - attraverso la nuova major. Deprecazione per criteri (vedere l'articolo 12).
Idempotenza: «Idempotency-Key» su POST/PUT/PATCH transazioni monetarie/critiche; salvataggio a N ore.
Paginazione: cursori ('nextPageToken'), non offset/limit; ordinamenti consistenziali.
Limiti: '429 Too Many Recests' + titoli di quote (' X-RateLimit - '), jitter in retrai.
Errori: codici di lettura automatica/sottocartelle, «correlationId», mappa dei campi di convalida.
Timeout e retrai: ritardo esponenziale + jitter; Non ritrarre errori pericolosi.
Criteri di compatibilità: immutabilità del significato dei campi i nuovi campi sono opzionali.

5) Modello evento e pneumatico (EDA)

Registratore diagramma - Contratto per ogni evento, evoluzione con backward.

• `click`, `session`, `bet`/`spin`, `round_start`/`round_result`,
• `deposit`/`withdrawal`, `psp_auth`, `kyc_status`, `fraud_signal`,
• `reward_granted`, `leaderboard_update`, `feature_toggle`.
• Le chiavi delle partiture sono «playerId», «campaignId», «tableId», «operatorId» (scelta di dominio).
• Spedizione: at-least-once con idoneità aziendale; per i risultati finanziari - saga/txn-outbox.
• Ordine: ordine garantito all'interno della chiave, chiavi crociate all'interno dell'orchestra.
• Semantica del tempo: «eventTime» + «ingestTime»; Deadup dì (eventId'idempotencyKey) ".

6) Web hook e garanzie di consegna

Firma: JWS/HMAC con «t» (timestamp) e «kid», controllo della finestra © 5 minuti, non è consentito il contagio.
Retrai: backoff con jitter fino a T minuti, fissazione tentativi, riordino solo a 5xx/timeout.
Idampotenza: «eventId» + firma del corpo; elaborazione «almeno una volta».
Registro eventi Web: ripetizione della cronologia durante la rassincronizzazione.
Sicurezza: se possibile, allow-list IP/ASN, CSRF non è applicabile alle salsicce server.

7) Dati e privacy (Privacy-by-Design)

Riduzioni PII: Tornizzazione degli identificatori (alias «playerId»), separazione dei domini dei dati.
Contratti dati: DPA/DPIA, obiettivi, conservazione, flussi transfrontalieri (Whitelist Paesi).
Criteri di controllo/linea: chi/quando/perché; login invariati (WORM).
Regole RG/etica: vietare gli off-off aggressivi per i segmenti vulnerabili; Un quadro legale ben definito.

8) Coerenza e transazioni

Forte consistenza - portafogli/bilanci/pagamenti.
Avvenual - vetrine, liderboard, telemetria.
Sags per transazioni aziendali distribuite risarcimenti per le persone.
Exactly-once in termini di business - chiavi idompotenti e elaboratori determinati.

9) Osservabilità e SLO

Tracing: «traceId» da click/webhook a pagamento/premio; propagation (`W3C traceparent`).
Metriche: p50/p95/p99 API, broker, CR pagamenti/CUS, leader E2E.
Loghi: strutturati, senza PDN; occultamento di token/chiavi.
Fogli SLO: login p95, 300-500 ms; deposito p95 ≤ 1. 5–2. 0 c; puntata/spin p95, 150-250 ms; La consegna degli eventi ≥ 99. 9%.

10) Prestazioni, quote, protezione contro la tempesta

Rate limiting (token/leaky bucket) su L7 e nelle politiche di mesh.
Backpressure: code prima degli upstream fragili (PSP/KYC).
Outler-ejection: raffreddamento automatico dei backend instabili.
Circuito-breaker - Chiude il flusso quando si superano le soglie di errore/latenza.
Fair-share: quote di tenante/canale/regione; Priorità dei domini critici.

11) Compatibilità SDK e criteri di prova

Set SDK: client HTTP/gRPC, firma delle richieste, retrai con jitter, idampotenza, cursori.
Test contrattuali: Postman/Newman/gRPC-conformance, simulatori PSP/KYC/studio.
Matrice di compatibilità: API/SDK, schemi supportati, criteri di deprecazione.
Sintetico: generatori di eventi e transazioni, scatole nere 24/7 per il monitoraggio.

12) Versioning e deprecazione (Change Management)

Le release maggiori sono una volta in N mesi, con una finestra parallela di 6-12 mes.
Minor - Aggiunge campi/metodi opzionali senza interruzioni.
Deprecazione: l'annuncio di un messaggio di avvertenza in intestazione/risposta, il flag nelle metriche è .
Migrazione di diagrammi di eventi - Strategia di espansione (add-only) + adattatori proxy ai confini.

13) Sicurezza dei protocolli

Zero Trust: mTLS dappertutto, credenze a breve termine, principi di privilegi minimi.
Segretezza - Separare chiavi di lettura/scrittura/amministrazione.
Protezione contro le ripetizioni: nonce/finestra temporale delle firme; Divieto di riutilizzo.
Filtri WAF/bot - Protezione da screaping/click-frod; basso false positive.
Zone vendute: microsegmentazione, singoli VPC/namespace-e, egress-allow-list.

14) Incidenti e DR

Procedure war-room: pulsante di stop per i domini (contenuto/PSP/KYC), RACI, SLA per il pacchetto trace.
Script DR: attivo-attivo punti di ingresso (Anycast/GSLB), cut-over 60-90 c, esercizio trimestrale.
RCA: modelli senza ricerca di colpevoli, comunicazione di L3↔L7, update a protocollo/SDK/Runbook.

15) Metriche di successo dei protocolli

Compatibilità: percentuale di partner sottoposti a test conformance timeout (TTO).
Affidabilità: uptime integrazioni, p95 API/bus, percentuale di webhoop di successo.
Sicurezza: incidenti PDN = 0, tempo di rotazione chiavi, quota di traffico mTLS.
Economia: cost per rps/txn/event, riduzione di Cost-to-Cerve, tempo di migrazione.
Prodotto: FTD/ARPU/LTV uplift da standardizzazione (meno perdite di CUS/pagamenti).

16) Anti-pattern

«Libera forma» eventi: nessun schema o versione per separare vetrine e analisti.
Un unico gateway L7 senza N + 1: SPOF e gola stretta per webhoop/PSP.
Retrai senza limiti/jitter: traffico-tempesta, ripresa transazioni.
PDN crudi nello scambio: senza tokenizzazione/DPIA, i rischi regolatori sono aumentati.
Paginazione offset: omissioni/duplicati sotto carico.
Segreti «per sempre» e IP statici senza egress-control.
Modifiche breaking senza una finestra e adattatori paralleli.

17) Assegno-foglio di implementazione

1. Accetta l'API canonica (versioning, idampotenza, paginazione, errori).
2. Inserisci Schema Registry e la mappa di dominio topic/chiavi partiture.
3. Obbliga mTLS + JWS/HMAC per S2S e webhoop; automatizzare la rotazione delle chiavi/JWKS.
4. Configura i limiti/retrai/CB/outlier-ejection e le quote per-tenant.
5. Espandere tracking/metriche/logi con un unico «traceId»; Approvare i fogli SLO.
6. Firmare DPA/DPIA, attivare la tornizzazione e i criteri di conservazione/rimozione.
7. Crea set SDK e conformance Fissare la politica di deprecazione.
8. Eseguire esercitazioni DR/chaos e rituali war-room; «Black Start» sul set minimo.
9. Implementare la directory dei protocolli (portale partner): speck, esempi, simulatori, arenaria.

18) Road map dell'evoluzione

v1 (Fondazione) canonica, schemi di eventi di base, firme di webhoot, .
v2 (Integration) - Catena di montaggio delle migrazioni, test di conformazione, SDK, rule-engine per quote/retrai.
v3 (Automation) - Dosaggio automatico per SLI, arenili self-service/simulatori, adattatori tra le versioni.
v4 (Networked Governance) - Comitato di protocolli interparter, SLO/crediti/penali comuni, PoP/edge policy congiunte.

Breve riepilogo

I protocolli comuni di interazione sono «linguaggio» dell'ecosistema: API ed eventi unificati, sicurezza rigorosa (mTLS/JWS), idermotia e garanzie di consegna, osservabilità e SLO, migrazioni gestite e DRC. Seguendo la canonica, i partecipanti scendono più velocemente, diminuiscono meno spesso, si scalano più facilmente e crescono prevedibilmente, nel rispetto della privacy e delle giurisdizioni.