Saltar a contenido

Portal de documentación de Tarno

Tarno expone un contrato de lectura neutral sobre el corpus de marcas de INAPI: una API REST (sin prefijo de versión) y un servidor Model Context Protocol (MCP), ambos respaldados por la misma capa de consultas y los mismos esquemas, de modo que los dos transportes devuelven resultados idénticos. Este portal es la documentación de puesta en marcha orientada a personas; es neutral y reutilizable entre consumidores.

El esquema autoritativo vive en la referencia OpenAPI en vivo en https://api.tarno.cl/docs (una página Scalar interactiva generada a partir de los esquemas que el servidor usa de verdad). Estas guías explican cómo hacer la puesta en marcha y enlazan a esa referencia — no duplican el esquema. Cuando el detalle de un campo o endpoint no está especificado aquí, la referencia es la fuente de verdad.

Guías de integración

Guía Qué cubre
Primeros pasos URL base https://api.tarno.cl, obtener una clave emitida por el operador, la primera llamada GET /trademarks (curl + TS fetch), paginación por cursor keyset, el sobre results[] y el cuerpo de error RFC 9457.
Autenticación y scopes El encabezado X-API-Key, los scopes (vacío = sólo las lecturas base), el ciclo de vida de la clave (rotar/revocar/expiración) y la semántica de 401 / 403 / 429.
Conecta tu agente de IA (MCP) El endpoint https://mcp.tarno.cl, X-API-Key, el transporte Streamable HTTP, el catálogo de 54 herramientas, 4 recursos y 3 guiones, y configuraciones de cliente de ejemplo.
Búsqueda por campos Buscar acotando el texto a un campo (denominación, titular, representante, RUT) y el modo avanzado.
Vigilancia de parecidos Vigilar solicitudes por número y leer sus parecidas: /watch/applications y /watch/hits.
Webhook «sync terminado» El aviso sync.finished al terminar la cadena diaria, su firma y la entrega de prueba.
Informes y oposiciones Boletín diario, despeje, panorama de conflictos, cartera y escritos de oposición.
Base documental (Directrices y leyes) Las Directrices de INAPI, los textos de las leyes, tasas e indicadores (legal:read).
Análisis y cálculo Comparar marcas, estadísticas por clase, plazos, días hábiles y tasas.
Búsqueda de personas Partes (titulares y representantes), sus marcas, relaciones y desenlaces.
Ejemplos de código Clientes REST (curl + TS fetch) y MCP (@modelcontextprotocol/sdk) listos para copiar y pegar.

Contrato y operaciones

Documento Qué cubre
Estado Estado del servicio y dónde se muestran la frescura/salud en vivo.
Versionado y deprecación El contrato sin prefijo de versión: se versiona por su changelog, con fecha de contrato como versión.
SLA Disponibilidad comprometida, RPO/RTO, mantenimiento, frescura y soporte.
Calendario de feriados El calendario legal chileno que el corpus usa para contar días hábiles: GET /holidays, con la cobertura declarada en meta.coverage.
Modelo de datos Las entidades que devuelve la API (marca, anotación, parte, clase, norma, informe, vigilancia), sus campos y cómo se relacionan.
Cobertura histórica Hasta dónde llega el corpus de marcas hacia atrás (distinto del calendario de feriados).
Changelog del contrato Cada cambio de la API y del MCP desde el 2026-09-17, con su etiqueta ([BREAK], [BEH], [ADD]…), su fecha y qué tienes que hacer.
Documentos legales Términos de servicio, política de datos personales, encargo de tratamiento (DPA) y subencargados.

Referencia autoritativa de la API

El esquema REST completo, generado de los esquemas y siempre actualizado por campo, es la referencia OpenAPI (Scalar) interactiva servida en https://api.tarno.cl/docs. Comienza con las guías anteriores para la puesta en marcha y luego usa esa referencia como el esquema canónico para cada endpoint, parámetro y forma de respuesta.