Como consultar o status operacional do Tarno ao vivo

O Tarno expõe um contrato de leitura sobre o corpus neutro do INAPI, mantido fresco por três fontes do INAPI. Todos os sinais operacionais — liveness, atualidade do corpus e histórico de sync — são consultáveis por você em tempo real através dos endpoints abaixo.

Esta página não incorpora um dashboard ao vivo: os sinais são expostos pela API, não por esta página. Em vez de mostrar valores que ficariam velhos, ela ensina quais endpoints chamar você mesmo para ler o status atual a qualquer momento.

Ao longo desta página a URL base é escrita como a variável de ambiente TARNO_BASE_URL (= https://api.tarno.cl) e a chave como TARNO_API_KEY. Substitua o marcador <API_KEY> pela sua chave real em tempo de execução; nunca a suba ao controle de versão.

export TARNO_BASE_URL="https://api.tarno.cl"
export TARNO_API_KEY="<API_KEY>"   # a chave opaca que seu operador emitiu

Liveness

GET /health é a sonda de liveness pública — é o único sinal que não requer chave. Retorna 200 quando o serviço está saudável e 503 quando está degradado.

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

Um 200 confirma que o contrato de leitura está de pé; um 503 indica que o serviço está degradado.

Atualidade do corpus

Três fontes do INAPI mantêm o corpus fresco. A atualidade por fonte — quão recente é o dado de cada uma contra um limite de staleness — é reportada ao vivo por GET /v1/freshness (escopo insights:read):

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

Para o histórico de execuções de sync (quando cada pipeline rodou e seu resultado), chame GET /v1/sync-runs (escopo insights:read):

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

A tabela abaixo é apenas uma referência de com que frequência o INAPI publica cada fonte — não é um valor de status. A verdade ao vivo sobre quão fresca cada fonte está agora vem de GET /v1/freshness, não desta tabela.

Fonte	Cadência de publicação do INAPI (referência)
Sheets	Diária
Estado-Diario	Segunda a sexta (horário de Santiago)
Buscador	Contínua (scraped no cron gerenciado)

Contrato de leitura

Estas são as superfícies operacionais do Tarno e como verificar cada uma você mesmo:

Superfície	Como verificá-la
API REST (/v1)	Autenticada por chave; verifique com qualquer GET /v1/... (p. ex. GET /v1/freshness).
Servidor MCP (Streamable HTTP)	Autenticado por chave; ferramentas em paridade com REST; veja o guia de MCP.
Referência OpenAPI (https://api.tarno.cl/docs)	Pública; abra no navegador para explorar o esquema interativo.
Liveness (/health)	Pública; use o curl da seção Liveness.

Disponibilidade e atualidade esperada

A postura de disponibilidade (máquina única, melhor esforço) e a cadência de atualidade esperada estão documentadas no SLA. Trate GET /v1/freshness, não esta página, como a verdade ao vivo sobre quão fresco o corpus está neste momento.