Conceptos
Los conceptos que conviene saber
Cómo está organizada la API y las convenciones que se repiten en todos los endpoints: fechas, dinero, paginación, idioma y la regla de oro, «cita o calla».
Las cuatro APIs y sus recursos
| API | Recursos | Rutas |
|---|---|---|
| Empresas (BORME) | Empresas, personas, boletines, provincias y estadísticas del Registro Mercantil publicadas en el BORME | /v1/dev/empresas, /personas, /boletines, /provincias, /estadisticas, /estado |
| Biblioteca jurídica | Normas y artículos del BOE con sus versiones y su vigencia | /v1/dev/biblioteca/* |
| Calculadoras y plazos | Cálculos jurídicos puros (indemnizaciones, intereses, penas…) y cómputo de plazos | /v1/dev/calculadoras/*, /v1/dev/plazos/* |
| Asistente | Una pregunta con respuesta citada, sólo con la biblioteca pública | /v1/dev/asistente |
Todas cuelgan de la misma base, https://app.jurilia.com/v1/dev, y se autentican con la misma clave. Ninguna expone datos de un despacho: son fuentes públicas y operaciones puras.
Fechas
Las fechas son fechas civiles sin zona horaria, en formato AAAA-MM-DD (por ejemplo 2026-10-03), también para plazos y cómputos. Un mes se pide como AAAA-MM. Los únicos instantes con hora son los que dicen ahora o ...En y van en ISO 8601 (UTC).
Dinero
Todo el dinero son enteros en céntimos de euro, nunca decimales: importeCentimos: 3877500 son 38.775,00 €. Los campos que lo llevan acaban en Centimos, también el saldo y lo cobrado.
Paginación y límites de resultados
- Las búsquedas aceptan
limite(el máximo está en la referencia de cada una: 100 en empresas, 20 en la búsqueda de la biblioteca). - La ficha de una empresa se pagina con el parámetro
pagina(de 1 en adelante). - Una consulta de pago cuesta lo mismo traiga los resultados que traiga: se cobra por llamada, no por resultado (ver Precios y facturación).
Idioma
Los mensajes de error, los textos de las calculadoras y las respuestas del asistente están en castellano, y el derecho que se cita es el español. Los códigos de error (codigo) son estables y pensados para programas; el mensaje es para personas.
Fuentes y citas: «cita o calla»
Ninguna afirmación jurídica sale sin su fuente: norma, artículo y versión, con el enlace oficial al BOE (urlOficial). Si no hay fuente, la API lo dice —desenlace: "sin_fuentes" o un artículo «que no está»— y no contesta de memoria. Las respuestas del asistente además llevan la verificación de cada cita (verificacion: verde, ámbar o rojo).
El estado «propuesto»
Lo que genera la IA nace con estado: "propuesto" y lleva un aviso: no es asesoramiento jurídico hasta que lo valide un abogado. Quien integre la API debe mostrar ese aviso y no presentar la respuesta como definitiva.
Versiones y contrato
La ruta lleva la versión (/v1/…). El contrato de la API del portal es un OpenAPI 3.1 generado del propio código (openapi.dev.v1.json): lo que dice la referencia sale de él. Los cambios se anotan en el registro de cambios.
Pendiente de decidir
La política de versiones (cuánto antes se avisa de un cambio incompatible y cuánto tiempo convive una versión con la siguiente) no está decidida todavía. Cuando lo esté se publicará aquí.