API Temis

Todo lo que hace Temis está disponible como API JSON, sin autenticación en esta versión. Las respuestas llevan siempre trazabilidad: fuente consultada, parámetros exactos, proveedor y modelo de IA. La documentación interactiva (OpenAPI/Swagger), con los esquemas completos de cada modelo, está en /docs (también como ReDoc en /redoc, y el esquema crudo en /openapi.json). Todas las respuestas con resultados incluyen trazabilidad (fuente, parámetros exactos, proveedor y modelo de IA) y, cuando procede, una nota que explica el ámbito de la búsqueda (recurso a normativa estatal o europea).

Pruébala en vivo: /docs

La documentación interactiva OpenAPI permite lanzar cada endpoint desde el navegador, con los esquemas completos de peticiones y respuestas y ejemplos precargados. Es la referencia canónica de la API.

Consultas

POST /consulta

Pregunta en lenguaje natural. La IA la convierte en una búsqueda estructurada y el sistema recupera normas con recurso automático autonómico → estatal → Unión Europea. Devuelve uno de tres tipos: resultados (normas ordenadas y cribadas + respuesta redactada con citas por artículo), redirect_oficial (la comunidad no ofrece acceso programático a ese rango; enlace preparado a su buscador) o error_consulta (con el motivo).

Campos opcionales: comunidad y rango (fijan valores en lugar de deducirlos), proveedor (véase GET /proveedores; admite el prefijo openrouter) y redactar_respuesta (false omite la redacción de IA).

curl -X POST http://localhost:4000/consulta \ -H "Content-Type: application/json" \ -d '{"pregunta": "¿Qué dice la ley de vivienda de Andalucía?"}'
POST /comparar

La misma materia contra las 17 comunidades autónomas en paralelo. Sin redacción de IA: comparación determinista de fuentes, con hasta max_por_comunidad normas por comunidad (por defecto 3), ordenadas con criterio jurídico.

curl -X POST http://localhost:4000/comparar \ -H "Content-Type: application/json" \ -d '{"pregunta": "regulación de las viviendas de uso turístico", "max_por_comunidad": 2}'

Normas

GET /norma/{identificador}

Una norma del BOE con sus metadatos oficiales (vigencia, estado de consolidación, ELI), su texto consolidado completo y sus artículos: cada uno con texto, fecha de vigencia y enlace con ancla directa al texto oficial.

Con ?fecha=AAAA-MM-DD el texto se reconstruye tal como estaba vigente en esa fecha, eligiendo por bloque la versión aplicable del consolidado oficial del BOE.

curl "http://localhost:4000/norma/BOE-A-2015-4747?fecha=2018-06-01"

Sistema

GET /cobertura

Mapa comunidad × rango: qué fuente atiende cada combinación, si está soportada con datos o deriva al buscador oficial, y el enlace verificado a cada portal. Incluye la fila de la Unión Europea (EUR-Lex).

GET /proveedores

Proveedores de IA configurados con su modelo, y el usado por defecto. Las claves de la lista son los valores válidos para el campo proveedor.

GET /derivaciones

Contador de derivaciones al buscador oficial por comunidad:rango. Es la medida objetiva de qué adaptador autonómico conviene construir después.

GET /salud

Comprobación de vida. Devuelve {"estado": "ok"}.