API Mis Casos.

Introducción

Esta API expone servicios para registrar alertas judiciales persistentes, enviar correos asociados a esas alertas, consultar acuerdos vinculados, administrar notas y directorios auxiliares, y recuperar catálogos necesarios para integraciones o tableros internos.

Inicio rápido

El flujo operativo base es: autenticar, consultar catálogos para resolver entidad y tribunal, crear una alerta persistente con su correo de notificación y después consultar acuerdos nuevos o completos por entidad o por alerta.

curl -X POST https://miscasos-expedientes.buholegal.com/api/v1/users/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "usuario_api",
    "password": "mi-password"
  }'

curl -H "Authorization: Bearer <token>" \
  https://miscasos-expedientes.buholegal.com/api/v1/info/fuentes

curl -X POST https://miscasos-expedientes.buholegal.com/api/v1/info/alertas/create/federal \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "nombre_alerta": "Mi alerta federal",
    "numero_expediente": "123/2025",
    "circuito": 1,
    "organismo": 10,
        "tipo_expediente": 1,
        "email": "destinatario@ejemplo.com"
  }'

curl -H "Authorization: Bearer <token>" \
  https://miscasos-expedientes.buholegal.com/api/v1/info/acuerdos/nuevos/federal

Autenticación

Los endpoints de usuario viven bajo /api/v1/users. El login y refresh no usan barra final. El endpoint me sí fue definido con barra final.

{
  "username": "usuario_api",
  "password": "mi-password"
}

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

Usuario autenticado

El endpoint /users/me/ devuelve información del usuario API, el vínculo con la cuenta BuhoLegal y la cuota de documentos disponible.

{
  "id": 10,
  "buhouser_id": 23453,
  "username": "user",
  "email": "user@email.com",
  "documents": 0,
  "max_documents": 5,
  "subscripcion": "Premium"
}

Catálogos

Antes de crear alertas conviene resolver la entidad, el juzgado o circuito, y en algunos casos el tipo de expediente. Todos estos endpoints viven bajo /api/v1/info.

Alertas

La API permite crear, listar, consultar, renombrar y eliminar alertas. La estructura del body cambia ligeramente entre federal y el resto de entidades. El campo email forma parte del alta operativa y se registra como correo de notificación de la alerta.

Crear alerta estatal

{
  "nombre_alerta": "Alerta sonora",
  "numero_expediente": "01025/2018",
  "juzgado": 21,
                            "tipo_expediente": 2,
                            "email": "destinatario@ejemplo.com"
}

Crear alerta federal

{
  "nombre_alerta": "Alerta federal",
  "numero_expediente": "1369/2015",
  "circuito": 1,
  "organismo": 10,
                            "tipo_expediente": 1,
                            "email": "destinatario@ejemplo.com"
}

Acuerdos

Los acuerdos pueden consultarse por entidad o por una alerta concreta. También existe variante para solo recuperar acuerdos nuevos. El detalle por alerta marca como leídos los acuerdos asociados.

Manejo de errores

La API usa códigos HTTP estándar. La mayoría de errores entregan un cuerpo con detail.

Referencia rápida

Soporte y recursos