Dê um ping no feed antes de consultá-lo

O seu script rodou aos quinze e a linha que ele escreveu está vazia. Antes de depurar o parser, a query ou o seu próprio código, há uma pergunta mais barata: o feed estava bem? A API responde a isso diretamente, e um preflight de duas linhas no topo de qualquer script te diz num segundo.

O batimento de graça

O feed expõe um endpoint público de vivacidade, GET /ping, que não precisa de chave e responde ok em texto puro, como a documentação de health check da rede descreve, verificado em 2026-11-05. Uma chamada curl do mesmo terminal que roda o seu script resolve se o serviço está respondendo:

curl -s "$ODDS_BASE_URL/ping"

Um ok significa que a porta da frente funciona. Qualquer outra coisa significa que o mistério da tarde está a montante, não no seu filtro jq. Essa é uma primeira checagem melhor que qualquer log seu, porque ela divide o problema ao meio por uma requisição.

A checagem detalhada, com a sua chave

Para mais que vivacidade, o mesmo serviço expõe um /health autenticado que informa o status de cada feed e quão frescas estão as suas escritas, com idades em milissegundos, verificado em 2026-11-05. Uma leitura saudável mostra idades de escrita bem abaixo de um segundo; uma degradada nomeia o feed e há quanto tempo ele está quieto.

Você não precisa disso em cada execução de um script de hobby. Você quer isso nos dois scripts que importam: o que alimenta uma tela que pessoas assistem, e o que alimenta os seus próprios registros. Quando os dados parecem errados ali, a leitura de saúde responde "é eles" antes de você queimar uma noite no "sou eu".

Onde o preflight pertence

Coloque o ping no topo do script e deixe-o decidir se a execução prossegue. Um padrão simples para qualquer quickstart deste site, como a primeira requisição com curl e jq, é: ping, e só se a resposta for ok, faça o poll. Um ping falho escreve uma linha no seu log e sai quieto, em vez de escrever uma linha vazia que se lê como mercado parado.

O mesmo padrão vale no Apps Script e no Python. Uma chamada de guarda, uma saída cedo, e a sua planilha nunca se enche de brancos que se disfarçam de dados.

O que o preflight não prova

Um ping vivo prova que a porta está aberta, não que a sua chave funciona, que o seu plano cobre o endpoint, ou que o seu esporte tem partidas hoje. Essas são as três próximas checagens, e elas falham diferente: 401 e 403 para a chave, erro de plano para o stream, lista de eventos vazia para uma rodada parada.

O hábito é ordenação, não esperteza. Porta, chave, plano, rodada: confira nessa ordem, e a maioria das tardes quebradas termina na primeira linha em vez da quarta hora.