Codici di errore dell'API quote
Risposta: gli errori REST arrivano come {"error": {"code", "message"}} con uno stato HTTP. I più comuni: 401 invalid_key, 403 plan_lacks_ws (Free/Hobby su /v1/stream), 403 sport_not_in_plan, 429 per i limiti. Nel WebSocket: chiusura 4001 chiave revocata, 4002 nessun subscribe entro 30 s, 4008 client lento, 1001 riavvio del server. Catalogo: errori.
Tabella rapida#
| Codice | Dove | Soluzione |
|---|---|---|
400 invalid_filter | REST, frame error del WS | Controlla i nomi di sport e mercato |
401 missing_key / invalid_key | REST, connessione WS | Invia una chiave ps_live_ valida |
403 plan_lacks_ws | Connessione WS | Passa a Builder |
403 sport_not_in_plan | REST (WS: frame error) | Scegli gli sport nella dashboard o cambia piano |
403 plan_lacks_history | /v1/closing | Builder o Pro |
plan_lacks_raw | Frame error del WS | format: "raw" richiede Pro |
429 rate_limited | REST | Attendi i secondi di Retry-After |
429 daily_quota | REST (Free) | Attendi le 00:00 UTC o cambia piano |
429 connection_limit | Connessione WS | Chiudi una connessione (Builder 3, Pro 10) |
chiusura 4008 | WS | Leggi più in fretta o restringi i filtri |
chiusura 1001 | WS | Riavvio: riconnetti con backoff |
Builder (99 €/mese) per WebSocket e storico di chiusura. Prova di 3 giorni; serve una carta, addebitata dopo il giorno 3 salvo disdetta. REST gratuito: registrazione. Vedi anche i limiti per piano.
Contenuto educativo per maggiorenni (18+).
Domande frequenti#
Un 403 chiude il socket?#
Il rifiuto per piano avviene sulla richiesta HTTP, prima dell'upgrade. I frame error in una connessione aperta non sempre la chiudono.
Cosa contiene il corpo di plan_lacks_ws?#
Un upgrade_url per iniziare la prova di Builder, con le condizioni della prova.
Dov'è l'elenco completo?#
In docs/errors.