API del asistente

API de asistente jurídico que cita sus fuentes

Envía una pregunta jurídica y recibe una respuesta construida sólo con la biblioteca pública, con cada cita comprobada contra el artículo. Si no hay fuente, responde sin_fuentes: no contesta de memoria. La respuesta nace «propuesto»: no es asesoramiento hasta que la valida un abogado.

Estado del acceso

El acceso está abierto

Crea tu cuenta de desarrollador, confirma el correo y activa el segundo factor (obligatorio) para crear tu clave. Biblioteca, calculadoras y plazos no gastan saldo; empresas y asistente tienen 100 consultas de prueba, sin tarjeta.

El acceso será para empresas de cualquier país, previa verificación.

Para quién es

  • Legaltech y software de gestión que quiere un asistente jurídico dentro de su producto sin entrenar ni mantener uno.
  • Equipos que construyen flujos con modelos de lenguaje y necesitan respuestas con cita verificable.
  • Quien quiere preguntar sobre un documento (PDF, Word, imagen) sin que se guarde.

Qué puedes hacer

Respuesta con citas verificadas

Contesta sólo con la biblioteca pública, citando artículo, norma y versión, y comprueba cada cita (verificacion: verde, ámbar o rojo). Si no hay fuente, desenlace: "sin_fuentes".

Preguntas sobre un documento

Admite PDF (con texto o escaneado), Word (.docx), JPEG y PNG en una petición multipart: hasta 5 ficheros, 10 MiB cada uno y 20 MiB en total. Se leen en memoria y no se guardan.

Datos personales tapados

Lo que escribes se seudonimiza antes de llegar al modelo; con ocultar añades nombres o direcciones que no se reconocen solos.

Gasto bajo control

Antes de llamar al modelo se reserva el peor caso; con maxCosteCentimos pones un tope y la respuesta dice lo cobrado. Si falla, no se cobra.

Las operaciones

  • POST/asistente

    Preguntar al asistente jurídico (respuesta citada) Detalle

    Consumo real del modelo ×5
  • GET/biblioteca/buscar

    Buscar artículos en la biblioteca jurídica Detalle

    Gratis
  • GET/saldo

    Consultar el saldo y la prueba restante Detalle

    Gratis

Ejemplos de petición y respuesta

Los ejemplos usan tu clave desde la variable de entorno JURILIA_API_KEY.

Hacer una pregunta

orden acerca la búsqueda a civil, penal, social o contencioso. Sólo responde en modo rápido.

curl

curl -X POST https://api.jurilia.com/v1/dev/asistente \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pregunta":"¿Cuánto tiempo hay para reclamar tras un despido?","orden":"social"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/asistente",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"pregunta":"¿Cuánto tiempo hay para reclamar tras un despido?","orden":"social"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const r = await fetch("https://api.jurilia.com/v1/dev/asistente", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"pregunta":"¿Cuánto tiempo hay para reclamar tras un despido?","orden":"social"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta (la forma; los valores son de ejemplo)

{
  "desenlace": "respondido",
  "texto": "…respuesta con sus citas…",
  "fuentes": [
    { "boeId": "BOE-A-…", "bloqueId": "…", "tituloNorma": "…", "abreviatura": "ET",
      "articulo": "59", "tituloBloque": "…", "vigenciaDesde": "AAAA-MM-DD",
      "vigenciaHasta": null, "urlOficial": "https://www.boe.es/…" }
  ],
  "verificacion": {
    "resultado": "verde", "verdes": 1, "ambares": 0, "rojas": 0,
    "citas": [{ "referencia": "ET:59.2", "resultado": "verde", "motivo": "…", "fuenteUrl": "https://www.boe.es/…" }]
  },
  "truncado": false,
  "estado": "propuesto",
  "aviso": "Respuesta generada por inteligencia artificial … debe validarla un abogado antes de usarla.",
  "cobradoCentimos": 3,
  "saldoCentimos": 9997,
  "facturacion": { "cobradoCentimos": 3, "deLaPrueba": false, "saldoRestanteCentimos": 9997, "pruebaRestante": 0, "ocrCentimos": 0 },
  "documentos": null  // con archivos: { "ficheros": 1, "paginas": 12, "paginasLeidasConOcr": 0, "caracteresEnviados": 21840, "recortado": false }
}  // cabeceras: X-Jurilia-Coste-Centimos, X-Jurilia-Saldo-Centimos, X-Jurilia-Prueba-Restante

Los valores son ilustrativos para que veas la forma exacta de la respuesta, no datos de una consulta real.

Por qué fiarse de lo que devuelve

Cita o calla

Cada afirmación jurídica lleva su fuente enlazada; si no la hay, sin_fuentes.

Verificación de cada cita

El resultado de la verificación (verde, ámbar o rojo) viaja con la respuesta: no tienes que fiarte de un texto sin comprobar.

El abogado valida

La respuesta nace propuesto y lleva el aviso de que la ha generado una IA.

Sin guardar tus archivos

Los archivos se procesan en memoria y se descartan al terminar la petición.

Límites y lo que no hace

  • Responde sólo con la biblioteca pública: no admite expedientes ni datos de un despacho, y una petición con campos de más se rechaza.
  • Sólo en modo rápido.
  • Archivos: hasta 5 por petición, 50 páginas por PDF y 100 por petición; la lectura de páginas escaneadas (OCR) tiene un tope de 20 páginas por petición.
  • La respuesta no es asesoramiento hasta que la valida un abogado.
  • 120 llamadas por minuto por clave.

Precio

Las 100 primeras consultas de empresas y asistente son de prueba, una sola vez y compartidas. Después se cobra el coste real del modelo multiplicado por 5, con un mínimo de 1 céntimo; el importe exacto depende de la pregunta y cada respuesta dice lo cobrado. Si el modelo falla, no se cobra nada.

Autenticación y errores

Cada llamada lleva la clave de tu cuenta de desarrollador en la cabecera Authorization: Bearer iuris_sk_…. La dirección base es https://api.jurilia.com. Hay un límite de 120 llamadas por minuto por clave, con las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset en cada respuesta. Una clave puede llevar una lista blanca de IP o redes (CIDR).

Los fallos llegan en JSON con un código estable: 401 (clave ausente o inválida), 402 (sin saldo: no se sirve ni se cobra), 403 (IP no permitida), 409 (falta un dato que decide el cálculo: no se cobra) y 429 (demasiadas llamadas seguidas).

Preguntas frecuentes

¿Qué hace el asistente cuando no encuentra una fuente?
Responde desenlace: "sin_fuentes" y no contesta de memoria: sin fuente enlazada no hay respuesta jurídica.
¿Cuánto cuesta una consulta?
Pasada la prueba, el coste real del modelo multiplicado por 5, con un mínimo de 1 céntimo. No hay tarifa fija por consulta: depende de la pregunta, y la respuesta indica lo cobrado.
¿Se pueden enviar documentos?
Sí: PDF, Word (.docx), JPEG o PNG en una petición multipart/form-data. Se leen en memoria, no se guardan y los datos personales se seudonimizan antes del modelo.
¿Puedo usar la respuesta directamente en un escrito?
No sin revisarla: nace propuesto y lleva el aviso de que la ha generado una IA. La valida un abogado.