Códigos de error de la API de cuotas
Respuesta: los errores REST llegan como {"error": {"code", "message"}} con un estado HTTP. Los más comunes: 401 invalid_key, 403 plan_lacks_ws (Free/Hobby en /v1/stream), 403 sport_not_in_plan, 429 por límites. En el WebSocket: cierre 4001 clave revocada, 4002 sin subscribe en 30 s, 4008 cliente lento, 1001 reinicio del servidor. Catálogo: errores.
Tabla rápida#
| Código | Dónde | Solución |
|---|---|---|
400 invalid_filter | REST, frame error del WS | Revisa nombres de deporte y mercado |
401 missing_key / invalid_key | REST, conexión WS | Envía una clave ps_live_ válida |
403 plan_lacks_ws | Conexión WS | Pasa a Builder |
403 sport_not_in_plan | REST (WS: frame error) | Elige deportes en el panel o mejora de plan |
403 plan_lacks_history | /v1/closing | Builder o Pro |
plan_lacks_raw | Frame error del WS | format: "raw" requiere Pro |
429 rate_limited | REST | Espera los segundos de Retry-After |
429 daily_quota | REST (Free) | Espera a las 00:00 UTC o mejora de plan |
429 connection_limit | Conexión WS | Cierra una conexión (Builder 3, Pro 10) |
cierre 4008 | WS | Lee más rápido o suscríbete a menos |
cierre 1001 | WS | Reinicio: reconecta con backoff |
Builder (€99/mes) para WebSocket e histórico de cierre. Prueba de 3 días; se requiere tarjeta y se cobra después del día 3 salvo que canceles. REST gratis: registro. Ver también límites por plan y autenticación.
Contenido educativo para mayores de 18 años.
Preguntas frecuentes#
¿Un 403 cierra el socket?#
El rechazo por plan ocurre en la conexión HTTP, antes del upgrade. Los frames error dentro de una conexión abierta no siempre la cierran.
¿Qué trae el cuerpo de plan_lacks_ws?#
Un upgrade_url para empezar la prueba de Builder, con las condiciones de la prueba.
¿Dónde está la lista completa?#
En docs/errors.