Ir para o conteúdo

Portal de documentação do Tarno

O Tarno expõe um contrato de leitura neutro sobre o corpus de marcas do INAPI: uma API REST (sem prefixo de versão) e um servidor Model Context Protocol (MCP), ambos apoiados na mesma camada de consultas e nos mesmos schemas, de modo que os dois transportes retornam resultados idênticos. Este portal é a documentação de primeiros passos voltada a pessoas; é neutro e reutilizável por qualquer consumidor.

O schema autoritativo vive na referência OpenAPI ao vivo em https://api.tarno.cl/docs (uma página Scalar interativa gerada a partir dos schemas que o servidor usa de verdade). Estes guias explicam como fazer os primeiros passos e apontam para essa referência — eles não duplicam o schema. Quando um detalhe de campo ou endpoint não estiver descrito aqui, a referência é a fonte da verdade.

Guias de integração

Guia O que cobre
Primeiros passos URL base https://api.tarno.cl, obtenção de uma chave emitida pelo operador, primeira chamada GET /trademarks (curl + TS fetch), paginação por cursor keyset, o envelope results[] e o corpo de erro RFC 9457.
Autenticação e escopos O header X-API-Key, os escopos (vazio = só as leituras base), o ciclo de vida da chave (rotacionar/revogar/expirar) e a semântica de 401 / 403 / 429.
Conecte seu agente de IA (MCP) O endpoint https://mcp.tarno.cl, X-API-Key, transporte Streamable HTTP, o catálogo de 54 ferramentas, 4 recursos e 3 roteiros, e exemplos de configuração de cliente.
Busca por campos Buscar restringindo o texto a um campo (denominação, titular, representante, RUT) e o modo avançado.
Vigilância de semelhantes Vigiar solicitações por número e ler as suas semelhantes: /watch/applications e /watch/hits.
Webhook «sync concluído» O aviso sync.finished ao terminar a cadeia diária, a sua assinatura e a entrega de teste.
Relatórios e oposições Boletim diário, disponibilidade, panorama de conflitos, carteira e petições de oposição.
Base documental (diretrizes e leis) As Diretrizes do INAPI, os textos das leis, taxas e indicadores (legal:read).
Análise e cálculo Comparar marcas, estatísticas por classe, prazos, dias úteis e taxas.
Busca de pessoas Partes (titulares e representantes), as suas marcas, relações e desfechos.
Exemplos de código Clientes REST (curl + TS fetch) e MCP (@modelcontextprotocol/sdk) prontos para copiar e colar.

Contrato e operações

Documento O que cobre
Status Status do serviço e onde ficam as superfícies ao vivo de atualidade/saúde.
Versionamento e descontinuação O contrato sem prefixo de versão: versionado pelo seu changelog, com data de contrato como versão.
SLA Disponibilidade comprometida, RPO/RTO, manutenção, atualidade e suporte.
Calendário de feriados O calendário legal chileno que o corpus usa para contar dias úteis: GET /holidays, com a cobertura declarada em meta.coverage.
Modelo de dados As entidades que a API devolve (marca, anotação, parte, classe, norma, relatório, vigilância), seus campos e como se relacionam.
Cobertura histórica Até onde o corpus de marcas chega para trás (distinto do calendário de feriados).
Changelog do contrato Cada mudança da API e do MCP desde 2026-09-17, com o seu rótulo ([BREAK], [BEH], [ADD]…), a sua data e o que você precisa fazer.
Documentos legais Termos de serviço, política de dados pessoais, acordo de tratamento de dados (DPA) e suboperadores.

Referência autoritativa da API

O schema REST completo, gerado dos schemas e sempre atualizado por campo, é a referência OpenAPI (Scalar) interativa servida em https://api.tarno.cl/docs. Comece pelos guias acima para fazer os primeiros passos e, em seguida, use essa referência como o schema canônico para todo endpoint, parâmetro e formato de resposta.