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.