Skip to main content
GET
/
api
/
Expedientes
/
BuscarPorTexto
Buscar Expedientes
curl --request GET \
  --url https://api.example.com/api/Expedientes/BuscarPorTexto
{
  "200": {},
  "Exito": true,
  "Mensaje": "<string>",
  "Data": [
    {
      "Id": 123,
      "Folio": "<string>",
      "NombreSolicitante": "<string>",
      "FechaInicio": {},
      "Estado": "<string>",
      "ContenidoSolicitud": "<string>"
    }
  ]
}

Descripción

Este endpoint permite buscar expedientes mediante un filtro de texto que se aplica a los siguientes campos:
  • Folio
  • Nombre del Solicitante
  • Estado
  • Contenido de la Solicitud
La búsqueda no distingue entre mayúsculas y minúsculas y retorna todos los expedientes que contengan el texto buscado en cualquiera de estos campos.

Endpoint

GET /api/Expedientes/BuscarPorTexto

Parámetros de Query

filtro
string
Texto a buscar en los campos del expediente. Si se omite o está vacío, se retornan todos los expedientes.

Respuesta

Estructura de la respuesta exitosa

Exito
boolean
required
Indica si la operación fue exitosa
Mensaje
string
Mensaje descriptivo en caso de error
Data
array
Lista de expedientes que coinciden con el filtro

Ejemplos de Solicitud

Buscar expedientes con el texto “presupuesto”

curl -X GET "https://api.ejemplo.com/api/Expedientes/BuscarPorTexto?filtro=presupuesto" \
  -H "Content-Type: application/json"

Buscar por nombre de solicitante

curl -X GET "https://api.ejemplo.com/api/Expedientes/BuscarPorTexto?filtro=Juan%20Pérez" \
  -H "Content-Type: application/json"

Buscar por folio

curl -X GET "https://api.ejemplo.com/api/Expedientes/BuscarPorTexto?filtro=2024-001" \
  -H "Content-Type: application/json"

Obtener todos los expedientes (sin filtro)

curl -X GET "https://api.ejemplo.com/api/Expedientes/BuscarPorTexto" \
  -H "Content-Type: application/json"

Ejemplo de Respuesta Exitosa

{
  "Exito": true,
  "Mensaje": null,
  "Data": [
    {
      "Id": 1,
      "Folio": "2024-001",
      "NombreSolicitante": "Juan Pérez García",
      "FechaInicio": "2024-01-15T10:30:00",
      "Estado": "Finalizado",
      "ContenidoSolicitud": "Solicito información sobre el presupuesto asignado al área de educación"
    },
    {
      "Id": 5,
      "Folio": "2024-005",
      "NombreSolicitante": "María González López",
      "FechaInicio": "2024-02-10T09:15:00",
      "Estado": "En proceso",
      "ContenidoSolicitud": "Información relacionada con presupuesto de obras públicas"
    }
  ]
}

Ejemplo de Respuesta sin Resultados

{
  "Exito": true,
  "Mensaje": null,
  "Data": []
}

Ejemplo de Respuesta con Error

{
  "Exito": false,
  "Mensaje": "Error al realizar la búsqueda: descripción del error",
  "Data": null
}

Códigos de Estado

200
OK
La solicitud se procesó correctamente. Revise el campo Exito para determinar si hubo errores en el procesamiento.

Campos Buscables

La búsqueda se realiza en los siguientes campos:
  • Folio: Número de identificación del expediente
  • NombreSolicitante: Nombre completo de la persona que realizó la solicitud
  • Estado: Estado actual del expediente (ej: “En proceso”, “Finalizado”, “Pendiente”)
  • ContenidoSolicitud: Descripción completa de lo solicitado

Notas Adicionales

  • La búsqueda no distingue entre mayúsculas y minúsculas
  • La búsqueda utiliza coincidencia parcial (el filtro puede estar contenido en cualquier parte del campo)
  • Si el parámetro filtro está vacío o no se proporciona, se retornan todos los expedientes del sistema
  • Los resultados incluyen solo campos resumidos del expediente; use el endpoint de Lista para obtener todos los campos
  • Use codificación URL para caracteres especiales en el filtro (ej: espacios como %20)

Build docs developers (and LLMs) love