API CasusLegal

Conexión

Es una REST API. Se conecta a su aplicación basada en cualquier LLM o a cualquier cliente HTTP como herramienta externa que su modelo utiliza para buscar en la jurisprudencia.

Base URL: https://lk.casus.legal

Autenticación: encabezado Authorization: Bearer cl_live_…

Formato: JSON mediante HTTPS.

1. Obtener la clave

1. Inicie sesión en el Área personalA través de Telegram o mediante correo electrónico y contraseña, en la misma cuenta que utiliza para el bot y el chat web.
   Sección «API»
2. Solicite acceso a través de «Mensajes»Describa la tarea y el volumen previsto de consultas. La emisión autónoma de nuevas claves está cerrada.
   Escribir al administrador
3. Espere a que se acuerden las condicionesEl administrador informará sobre la posibilidad de conexión, los límites y el procedimiento para obtener la clave. La clave obtenida cl_live_… guárdela de inmediato: no se puede recuperar. La compra de un paquete de chat no habilita la API.

2. Primera solicitud

curl -X POST https://lk.casus.legal/v1/search \
  -H "Authorization: Bearer $CASUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "договор энергоснабжения, фактическое потребление", "limit": 15}'

import os, httpx

client = httpx.Client(
    base_url="https://lk.casus.legal",
    headers={"Authorization": f"Bearer {os.environ['CASUS_API_KEY']}"},
    timeout=60,
)

r = client.post("/v1/search", json={
    "query": "снижение неустойки по статье 333 ГК",
    "limit": 15,
    "mode": "hybrid",
})
r.raise_for_status()
data = r.json()
for hit in data["results"]:
    print(hit["court"], hit["date"], hit["case_number"], hit["url"])

3. Endpoints

POST /v1/searchdescuenta 1 solicitud

Búsqueda híbrida. Descuenta 1 solicitud únicamente cuando la respuesta es satisfactoria.

La estructura de la respuesta proporciona bloques preparados según la jerarquía de los tribunales. Construya la respuesta a partir de ellos, sin realizar una solicitud separada para cada tribunal.

{
  "_response_format_hint": "…директива формата ответа…",
  "constitutional_context": { "items": [ … ] },   // КС
  "vs_guidance":            { "items": [ … ] },   // Пленумы и обзоры ВС
  "latest_practice":        { "items": [ … ] },   // свежие определения коллегий ВС
  "vas_history":            [ … ],                // история: практика ВАС
  "results": [
    {
      "id": 12345, "court": "СКЭС", "date": "10.05.2024",
      "case_number": "305-ЭС24-12345", "title": "…", "snippet": "…",
      "score": 0.87,
      "url": "https://lk.casus.legal/case/12345?t=<токен>"
    }
  ],
  "_supersession_alert": "…",   // при наличии отменённого и действующего акта
  "expansion": { … }
}

GET /v1/cases/{id}gratuito

Ficha del acto: datos identificativos, sections (texto por secciones), articles, hashtags y enlaces url / url_md / url_docx. Utilícelo para citas literales de los actos clave. No consume cuota.

curl https://lk.casus.legal/v1/cases/12345 \
  -H "Authorization: Bearer $CASUS_API_KEY"

4. Errores y límites

Todos los errores se reciben como JSON {"error": "<код>", "message": "…"}.

5. Buenas prácticas

• La clave solo en el backend. Guárdela en variables de entorno o secretos, no en el código, no en Git y no en el cliente.
• Reintentos con exponencial. En 429 y 5xx repita con una pausa creciente: 2 s, 4 s, 8 s.
• Almacene en caché las fichas. El contenido GET /v1/cases/{id} es estable y la llamada es gratuita.
• No modifique los enlaces. Campo url está firmado con un token con una duración aproximada de 30 días. Transmítalo tal cual.

Configuración de su LLM

La API proporciona material en bruto: fichas de actos, bloques temáticos y una indicación sobre el formato _response_format_hint. La calidad de la respuesta final la determina la instrucción del sistema de su LLM. A continuación se exponen principios para dos escenarios, no prompts preparados.

Escenario A. Respuesta en el chat (revisión de la práctica)

1. Una búsqueda, un limit amplio. Basta una sola llamada /v1/search con una solicitud pertinente y limit 15–20: la jerarquía de los tribunales ya llega en bloques. No divida el tema en solicitudes para cada tribunal.
2. Transmita al modelo _response_format_hint. Es una directiva de formato incorporada; tenerla en cuenta aproxima considerablemente la respuesta a una revisión de referencia.
3. El papel de «fuente de referencia, no asesor». Enumerar todos los actos pertinentes según la jerarquía (prioridad del Tribunal Constitucional, actualidad del Tribunal Supremo, Tribunal Supremo de Arbitraje como historia), sin recomendación final y sin elegir por el usuario la posición «correcta» única.
4. Enlaces estrictamente del campo url. Prohíba construir la dirección a partir de id y eliminar el token ?t=: sin él, el enlace no abrirá el texto.
5. Citas con moderación. Obtenga las citas literales mediante /v1/cases/{id} solo para 3–5 actos clave. En el Tribunal Constitucional la cita necesaria ya figura en el campo inline position. Esta es la principal fuente de tokens innecesarios.
6. Solo de los resultados. Prohíba completar la práctica de memoria: lo que no figure en la respuesta de la API «no está en la base de datos».

Escenario B. Elaboración de un catálogo de práctica

Objetivo: una selección o lista de asuntos para exportar, sin análisis jurídico.

1. Primero, reduzca el ámbito mediante filtros. Haga que el modelo concrete el tema y aplique los filtros court / act_type / tag / article / year_from–year_to: el catálogo será pertinente y compacto.
2. Recopilación sin análisis. Tome de cada acto id, los datos identificativos (tribunal, tipo, fecha, n.º de asunto) y url. No parafrasee ni cite los actos en este modo.
3. Completitud mediante varias solicitudes. Para un tema amplio, realice varias /v1/search por subtemas, años o tribunales y combine los resultados, descartando los duplicados por id.
4. Devuelva una lista, no una conclusión. Resultado del modo: una tabla o lista con enlaces url, que el usuario filtrará por sí mismo.
5. Separación clara de los modos. Separe claramente este modo del escenario A para que el modelo no «derive» hacia un análisis detallado cuando se solicitó una selección.