Notas de quickstart
Haz ping al feed antes de sondearlo
Un endpoint público de ping responde si el servicio está vivo, antes de que tu script escriba una fila vacía. Una llamada de guardia al inicio del script.
Tu script corrió a y cuarto y la fila que escribió está vacía. Antes de depurar el parser, la consulta o tu propio código, hay una pregunta más barata: ¿el feed estaba bien? La API responde a eso directamente, y un preflight de dos líneas al inicio de cualquier script te lo dice en un segundo.
El latido gratis
El feed expone un endpoint público de vitalidad, GET /ping, que no necesita clave y responde ok en texto plano, como la documentación de health check de la red describe, verificado el 2026-11-05. Una llamada curl desde el mismo terminal que ejecuta tu script resuelve si el servicio está respondiendo:
curl -s "$ODDS_BASE_URL/ping"Un ok significa que la puerta principal funciona. Cualquier otra cosa significa que el misterio de la tarde está corriente arriba, no en tu filtro jq. Esa es una mejor primera comprobación que cualquier registro tuyo, porque divide el problema a la mitad por una solicitud.
La comprobación detallada, con tu clave
Para más que vitalidad, el mismo servicio expone un /health autenticado que informa el estado de cada feed y cuán frescas están sus escrituras, con edades en milisegundos, verificado el 2026-11-05. Una lectura sana muestra edades de escritura bien por debajo de un segundo; una degradada nombra el feed y cuánto lleva callado.
No necesitas esto en cada ejecución de un script de hobby. Lo quieres en los dos scripts que importan: el que alimenta una pantalla que la gente mira, y el que alimenta tus propios registros. Cuando los datos parecen mal ahí, la lectura de salud responde "son ellos" antes de que quemes una tarde en el "soy yo".
Dónde va el preflight
Pon el ping al inicio del script y deja que decida si la ejecución sigue. Un patrón simple para cualquier quickstart de este sitio, como la primera solicitud con curl y jq, es: ping, y solo si la respuesta es ok, sondea. Un ping fallido escribe una línea en tu registro y sale en silencio, en lugar de escribir una fila vacía que se lee como mercado parado.
El mismo patrón vale en Apps Script y en Python. Una llamada de guardia, una salida temprana, y tu hoja nunca se llena de blancos que se disfrazan de datos.
Lo que el preflight no puede probar
Un ping vivo prueba que la puerta está abierta, no que tu clave funciona, que tu plan cubre el endpoint, o que tu deporte tiene partidos hoy. Esas son las tres siguientes comprobaciones, y fallan distinto: 401 y 403 para la clave, error de plan para el stream, lista de eventos vacía para una jornada parada.
El hábito es el orden, no la astucia. Puerta, clave, plan, jornada: comprueba en ese orden, y la mayoría de las tardes rotas terminan en la primera línea en lugar de la cuarta hora.