Riferimento API pubblico

Integra il feed in pochi minuti.

Consulta liberamente contratti, parametri e risposte. La prova gratuita genera una API key personale valida 14 giorni.

Verifica servizio

Ottieni la chiave

Registrati online. Nel portale trovi Base URL, API key, WebSocket e moduli abilitati.

Invia la prima richiesta

curl "BASE_URL/api/v1/prematch/matches?limit=5" \
  -H "x-api-key: LA_TUA_API_KEY"

Sicurezza

Autenticazione

Usa l'header x-api-key. E' supportato anche Authorization: Bearer API_KEY. Non inserire la chiave nel frontend pubblico: inoltra le richieste dal tuo backend.

x-api-key: sfh_...Consigliato

WebSocket

Push Live

Mantieni una sola connessione per cliente e ricevi snapshot, eventi live e heartbeat.

ws://HOST/api/v1/live/ws?apiKey=API_KEY

Server-Sent Events

SSE Live

Alternativa HTTP persistente, utile quando l'infrastruttura non gestisce WebSocket.

BASE_URL/api/v1/live/stream

Contratto operativo

Errori e rate limit

400Parametri non validi

401API key mancante, non valida o scaduta

403Modulo o scope non abilitato

429Limite richieste raggiunto

La prova gratuita include 30 richieste/minuto. Per il live usa WebSocket o SSE invece del polling continuo.

OpenAPI 3.1

Endpoint

Il riferimento e' generato dalla specifica pubblica utilizzata dal servizio.