API Decisiones Judiciales

Introducción

La API Pública de Decisiones Judiciales es un servicio web desarrollado por el Poder Judicial que permite consultar información sobre decisiones judiciales de manera programática. Esta API proporciona acceso a datos de casos judiciales utilizando el Número Único de Caso (NUC) como identificador principal.

Información General

Requisitos Previos

Para utilizar esta API, necesitará:

• Conexión a Internet: Acceso estable a la red
• Cliente HTTP: Cualquier herramienta capaz de realizar peticiones HTTP (curl, Postman, navegador web, etc.)
• Número Único de Caso (NUC): El identificador del caso judicial que desea consultar
• Conocimientos básicos de:
  • Peticiones HTTP
  • Formato JSON
  • Manejo de respuestas paginadas

Endpoint Disponible

Parámetros de Consulta

Todos los parámetros se envían como query parameters en la URL.

Descripción Detallada de Parámetros

Nuc (Número Único de Caso)

• Identificador único del caso judicial
• Formato: Cadena de texto
• Ejemplo: "2024-0002365"

PaginaActual

• Indica qué página de resultados desea obtener
• Valor mínimo: 1
• Ejemplo: Para obtener los primeros resultados, usar 1

RegistrosPorPagina

• Define cuántos registros se devolverán en cada página
• Valor mínimo: 1
• Valor recomendado: Entre 10 y 100
• Ejemplo: 20 devolverá 20 registros por página

Estructura de Respuesta

Respuesta Exitosa (200 OK)

La API devuelve un objeto de paginación que contiene los siguientes campos:

{
  "paginaActual": 1,
  "totalPaginas": 5,
  "registrosPorPagina": 20,
  "totalRegistros": 100,
  "datos": [
    {
      "asunto": "Descripción del asunto",
      "categoriaTribunal": "Primera Instancia",
      "nuc": "2024-0002365",
      "numeroDecision": "001-2024",
      "fechaDecision": "2024-10-15T00:00:00",
      "urlDocumentoFirmado": "https://[url-documento]",
      "materia": "Civil",
      "sala": "Sala Civil",
      "tribunal": "Tribunal Superior",
      "tipoFallo": "Sentencia",
      "tipoDocumento": "Resolución"
    }
  ]
}

Campos de Paginación

Campos de Decisión Judicial

Ejemplos de Uso

Ejemplo 1: Consulta Básica con curl

curl -X GET "https://api.poderjudicial.gob.do/Decisiones/Decisiones/ObtenerDecisiones?Nuc=199-2020-ELAB-00094&PaginaActual=1&RegistrosPorPagina=10"

Ejemplo 2: Consulta con JavaScript (Fetch API)

const obtenerDecisiones = async (nuc, pagina, registrosPorPagina) => {
  const url = `https://api.poderjudicial.gob.do/Decisiones/Decisiones/ObtenerDecisiones?Nuc=${nuc}&PaginaActual=${pagina}&RegistrosPorPagina=${registrosPorPagina}`;

  try {
    const response = await fetch(url);

    if (!response.ok) {
      throw new Error(`Error HTTP: ${response.status}`);
    }

    const data = await response.json();
    console.log('Decisiones:', data);
    return data;

  } catch (error) {
    console.error('Error al consultar decisiones:', error);
  }
};

// Uso
obtenerDecisiones('199-2020-ELAB-00094', 1, 20);

Ejemplo 3: Consulta con Python (requests)

import requests

def obtener_decisiones(nuc, pagina_actual, registros_por_pagina):
    url = "https://api.poderjudicial.gob.do/Decisiones/Decisiones/ObtenerDecisiones"

    params = {
        'Nuc': nuc,
        'PaginaActual': pagina_actual,
        'RegistrosPorPagina': registros_por_pagina
    }

    try:
        response = requests.get(url, params=params)
        response.raise_for_status()

        data = response.json()
        print(f"Total de registros: {data['totalRegistros']}")
        print(f"Total de páginas: {data['totalPaginas']}")

        return data

    except requests.exceptions.RequestException as e:
        print(f"Error al consultar la API: {e}")
        return None

# Uso
decisiones = obtener_decisiones('199-2020-ELAB-00094', 1, 20)

Ejemplo 4: Consulta con C# (.NET)

using System;
using System.Net.Http;
using System.Text.Json;
using System.Threading.Tasks;

public class DecisionesClient
{
    private readonly HttpClient _httpClient;

    public DecisionesClient()
    {
        _httpClient = new HttpClient();
    }

    public async Task<PaginacionResponse<DecisionResponse>> ObtenerDecisiones(
        string nuc,
        int paginaActual,
        int registrosPorPagina)
    {
        var url = $"https://api.poderjudicial.gob.do/Decisiones/Decisiones/ObtenerDecisiones?" +
                  $"Nuc={nuc}&PaginaActual={paginaActual}&RegistrosPorPagina={registrosPorPagina}";

        try
        {
            var response = await _httpClient.GetAsync(url);
            response.EnsureSuccessStatusCode();

            var content = await response.Content.ReadAsStringAsync();
            var resultado = JsonSerializer.Deserialize<PaginacionResponse<DecisionResponse>>(content);

            Console.WriteLine($"Total de registros: {resultado.TotalRegistros}");
            return resultado;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
            return null;
        }
    }
}

Códigos de Estado HTTP

La API utiliza los siguientes códigos de estado HTTP estándar:

Limitación de Peticiones

La API implementa un sistema de limitación de peticiones (Rate Limiting) para garantizar un uso equitativo del servicio.

Comportamiento al Exceder el Límite

Cuando se excede el límite de peticiones:

1. Código de respuesta: 429 Too Many Requests
2. Mensaje de error:

{
  "error": "Ha superado el límite de peticiones permitidas."
}

Recomendaciones

• Implemente lógica de reintento con retroceso exponencial
• Distribuya sus peticiones a lo largo del tiempo
• Cache los resultados cuando sea posible
• Monitoree sus patrones de uso

Manejo de Errores

Error 400 - Parámetros Inválidos

{
  "message": "Errores de validación.",
  "codigoError": 400,
  "errores": [
    "Debe proveer un valor para el parámetro Nuc.",
    "El parámetro PaginaActual debe ser mayor a 0."
  ]
}

Error 404 - Sin Resultados

{
  "message": "No se encontraron resultados con los parámetros establecidos"
}

Error 500 - Error del Servidor

{
  "message": "Descripción del error interno"
}

Glosario