Códigos de erro da API de odds
Resposta: os erros REST chegam como {"error": {"code", "message"}} com um status HTTP. Os mais comuns: 401 invalid_key, 403 plan_lacks_ws (Free/Hobby em /v1/stream), 403 sport_not_in_plan, 429 por limites. No WebSocket: fechamento 4001 chave revogada, 4002 sem subscribe em 30 s, 4008 cliente lento, 1001 reinício do servidor. Catálogo: erros.
Tabela rápida#
| Código | Onde | Solução |
|---|---|---|
400 invalid_filter | REST, frame error do WS | Confira nomes de esporte e mercado |
401 missing_key / invalid_key | REST, conexão WS | Envie uma chave ps_live_ válida |
403 plan_lacks_ws | Conexão WS | Passe para o Builder |
403 sport_not_in_plan | REST (WS: frame error) | Escolha esportes no painel ou faça upgrade |
403 plan_lacks_history | /v1/closing | Builder ou Pro |
plan_lacks_raw | Frame error do WS | format: "raw" exige Pro |
429 rate_limited | REST | Espere os segundos de Retry-After |
429 daily_quota | REST (Free) | Espere até 00:00 UTC ou faça upgrade |
429 connection_limit | Conexão WS | Feche uma conexão (Builder 3, Pro 10) |
fechamento 4008 | WS | Leia mais rápido ou assine menos |
fechamento 1001 | WS | Reinício: reconecte com backoff |
Builder (€99/mês) para WebSocket e histórico de fechamento. Teste de 3 dias; é preciso cartão, cobrado após o dia 3 se você não cancelar. REST grátis: cadastro. Veja também limites por plano e autenticação.
Conteúdo educativo para maiores de 18 anos.
Perguntas frequentes#
Um 403 fecha o socket?#
A recusa por plano acontece na conexão HTTP, antes do upgrade. Frames error dentro de uma conexão aberta nem sempre a fecham.
O que vem no corpo de plan_lacks_ws?#
Um upgrade_url para iniciar o teste do Builder, com as condições do teste.
Onde está a lista completa?#
Em docs/errors.