Listar servicios con filtros

POST

/api/v1/external/servicios

Obtiene un listado paginado de servicios de transporte aplicando diversos filtros. Incluye protección de circuit breaker, timeout de 15 segundos y cache de 5 minutos. Rate limit: 10 solicitudes por minuto.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Búsqueda por fecha únicaBúsqueda por rango de fechasBúsqueda por IDs específicosBúsqueda con múltiples filtros

{
    "id_cliente": 1,
    "fecha": "2025-11-27",
    "pagina": 1,
    "porPagina": 20,
    "estado": "ASIGNADO"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Búsqueda por fecha únicaBúsqueda por rango de fechasBúsqueda por IDs específicosBúsqueda con múltiples filtros

curl --location --request POST '/api/v1/external/servicios' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id_cliente": 1,
    "fecha": "2025-11-27",
    "pagina": 1,
    "porPagina": 20,
    "estado": "ASIGNADO"
}'

Responses

🟢200Correcto

application/json

Listado de servicios obtenido exitosamente

Body

Examples

Respuesta exitosa con datosRespuesta desde cache

{
    "resultado": "OK",
    "datos": [
        {
            "id": 12345,
            "servicio": "Sede Principal-2025-11-27-07:00",
            "estado": "ASIGNADO",
            "placa": "ABC123",
            "fecha_string": "2025-11-27",
            "horario": "07:00",
            "site": "Sede Principal",
            "ciudad": "Bogotá",
            "tipo": "dinamica",
            "tipo_trayecto": "salida",
            "nro_pasajeros": 5,
            "km_trazado": 15.5,
            "duracion_ruta": 45,
            "creador_serivicio": "Juan Pérez",
            "tags": [
                {
                    "id": 1,
                    "nombre": "Prioritario",
                    "color": "#FF0000"
                }
            ]
        }
    ],
    "total": 150,
    "requestId": "ext_srv_1732744800000_abc123def",
    "responseTimeMs": 125,
    "cached": false
}

🟠400Solicitud incorrecta

🟠401No autenticado

🟠413El cuerpo de la solicitud es demasiado grande

🟠429Demasiadas solicitudes

🔴503Servicio no disponible

🔴504Tiempo de espera de la puerta de enlace

Modified at 2025-11-27 21:48:39

Obtener opciones de filtros disponibles

Almacenar archivo PDF