Obtener opciones de filtros disponibles

POST

/api/v1/external/servicios/filtros

Obtiene las opciones disponibles para filtrar servicios (ciudades, sites, horarios, estados, placas, tipos). Los datos se cachean por 5 minutos. Rate limit: 20 solicitudes por minuto.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Examples

Obtener todos los filtrosFiltros para servicios standardFiltros para servicios VIP

{
    "id_cliente": 1
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Obtener todos los filtrosFiltros para servicios standardFiltros para servicios VIP

curl --location --request POST '/api/v1/external/servicios/filtros' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id_cliente": 1
}'

Responses

🟢200Correcto

application/json

Opciones de filtros obtenidas exitosamente

Body

Examples

Respuesta con filtros disponiblesRespuesta desde cache

{
    "resultado": "OK",
    "datos": {
        "ciudad": [
            "Bogotá",
            "Medellín",
            "Cali",
            "Barranquilla"
        ],
        "site": [
            "Sede Principal",
            "Sede Norte",
            "Sede Sur"
        ],
        "horario": [
            "06:00",
            "07:00",
            "08:00",
            "17:00",
            "18:00"
        ],
        "estado": [
            "SIN ASIGNAR",
            "ASIGNADO",
            "EN CURSO",
            "FINALIZADO",
            "CANCELADO"
        ],
        "placa": [
            "ABC123",
            "DEF456",
            "GHI789"
        ],
        "tipo": [
            "ingreso",
            "salida"
        ],
        "tipo_servicio": [
            "dinamica",
            "ruta_fija",
            "ultra",
            "vip"
        ],
        "solicitud": [
            "RECHAZADO",
            "PENDIENTE",
            "APROBADO",
            "VENCIDO"
        ]
    },
    "total": 1250,
    "requestId": "ext_flt_1732744800000_xyz789abc",
    "responseTimeMs": 85,
    "cached": false
}

🟠400Solicitud incorrecta

🟠401No autenticado

🟠429Demasiadas solicitudes

🔴503Servicio no disponible

🔴504Tiempo de espera de la puerta de enlace

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

Documentación [Ext API]

Listar servicios con filtros