Cómo consultar el estado operacional de Tarno en vivo

Tarno expone un contrato de lectura sobre el corpus neutral de INAPI, que se mantiene fresco gracias a tres fuentes de INAPI. Todas las señales operacionales — liveness, frescura del corpus e historial de sync — son consultables por vos en tiempo real a través de los endpoints de abajo.

Esta página no incrusta un panel en vivo: las señales las expone la API, no esta página. En vez de mostrar valores que quedarían viejos, te enseña qué endpoints llamar tú mismo para leer el estado actual en cualquier momento.

A lo largo de esta página la URL base se escribe como la variable de entorno TARNO_BASE_URL (= https://api.tarno.cl) y la clave como TARNO_API_KEY. Reemplaza el marcador <API_KEY> por tu clave real en tiempo de ejecución; nunca la subas al control de versiones.

export TARNO_BASE_URL="https://api.tarno.cl"
export TARNO_API_KEY="<API_KEY>"   # la clave opaca que te entregó tu operador

Liveness

GET /health es la sonda de liveness pública — es la única señal que no requiere clave. Devuelve 200 cuando el servicio está sano y 503 cuando está degradado.

curl -sS -o /dev/null -w "%{http_code}\n" "$TARNO_BASE_URL/health"

Un 200 confirma que el contrato de lectura está en pie; un 503 indica que el servicio está degradado.

Frescura del corpus

Tres fuentes de INAPI mantienen fresco el corpus. La frescura por fuente — qué tan reciente es el dato de cada una contra un umbral de staleness — la reporta en vivo GET /v1/freshness (scope insights:read):

curl -sS "$TARNO_BASE_URL/v1/freshness" -H "X-API-Key: $TARNO_API_KEY"

Para el historial de ejecuciones de sync (cuándo corrió cada pipeline y su resultado), llama a GET /v1/sync-runs (scope insights:read):

curl -sS "$TARNO_BASE_URL/v1/sync-runs" -H "X-API-Key: $TARNO_API_KEY"

La siguiente tabla es solo una referencia de con qué frecuencia publica INAPI cada fuente — no es un valor de estado. La verdad en vivo sobre qué tan fresca está cada fuente ahora la da GET /v1/freshness, no esta tabla.

Fuente	Cadencia de publicación de INAPI (referencia)
Sheets	Diaria
Estado-Diario	Lunes a viernes (horario de Santiago)
Buscador	Continua (scrapeada en el cron gestionado)

Contrato de lectura

Estas son las superficies operacionales de Tarno y cómo verificar cada una tú mismo:

Superficie	Cómo verificarla
API REST (/v1)	Autenticada por clave; verifícala con cualquier GET /v1/... (p. ej. GET /v1/freshness).
Servidor MCP (Streamable HTTP)	Autenticado por clave; herramientas en paridad con REST; ver la guía de MCP.
Referencia OpenAPI (https://api.tarno.cl/docs)	Pública; ábrela en el navegador para explorar el esquema interactivo.
Liveness (/health)	Pública; usa el curl de la sección Liveness.

Disponibilidad y frescura esperada

La postura de disponibilidad (máquina única, mejor esfuerzo) y la cadencia de frescura esperada están documentadas en el SLA. Trata GET /v1/freshness, no esta página, como la verdad en vivo sobre qué tan fresco está el corpus en este momento.