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 /system/freshness (escopo
insights:read):
curl -sS "$TARNO_BASE_URL/system/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 /system/sync-runs (escopo insights:read):
curl -sS "$TARNO_BASE_URL/system/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 /system/freshness, não desta tabela.
| Fonte | Cadência de publicação do INAPI (referência) |
|---|---|
| Dados abertos do INAPI | Diária (a cadeia do Tarno não roda aos domingos) |
| Estado-Diario | Segunda a sexta (horário de Santiago) |
| Fichas de processo do INAPI | Contínua (consultada uma vez por dia, de segunda a sábado, na cadeia diária) |
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 | Autenticada por chave; verifique com qualquer endpoint protegido (p. ex. GET /system/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
Os compromissos de disponibilidade, recuperação (RPO/RTO) e manutenção, e a cadência de atualidade
esperada, estão no SLA. Trate GET /system/freshness, não esta página, como a verdade
ao vivo sobre quão fresco o corpus está neste momento.