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.

wss://livefeedapi.com/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

Refertazione calcio

Mercati giocatore Plus

Le regole includono il giocatore selezionato e la catena dei suoi sostituti diretti. Gli esiti vengono pubblicati nell'endpoint risultati prematch.

`gls / AnytimePlus`

La selezione e' vincente se il giocatore indicato, oppure un suo sostituto diretto, segna almeno un gol o colpisce un palo o una traversa.

`shont_plus`

Somma i tiri in porta e i pali/traverse del giocatore indicato e dei suoi sostituti diretti. La soglia richiesta e' riportata nel campo header, per esempio 1+.

WONLa condizione del mercato e' stata verificata.

LOSTIl referto individuale e' completo e la condizione non si e' verificata.

VOIDLa mancata partecipazione e' stata confermata secondo la regola del mercato.

PENDINGManca ancora una prova individuale sufficiente. Non deve essere interpretato come LOST.

Il cliente deve liquidare soltanto selezioni con settlement diverso da PENDING. La distribuzione delle quote Plus e' limitata ai campionati certificati; se manca l'attribuzione individuale di palo/traversa, missingEvidence vale PLAYER_WOODWORK_NOT_AVAILABLE.

Richiesta

GET /api/v1/results/prematch?eventId=199419071
GET /api/v1/results/prematch?betradarId=71945238

Selezione normalizzata

{
  "key": "gls",
  "name": "Goalscorer",
  "selections": [{
    "name": "PLAYER_NAME",
    "header": "AnytimePlus",
    "settlement": "PENDING",
    "substituteChain": ["SUBSTITUTE_NAME"],
    "missingEvidence": "PLAYER_WOODWORK_NOT_AVAILABLE"
  }]
}

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.