Listar vehículos del catálogo

Obtiene una lista paginada de vehículos del catálogo con opciones de filtrado.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

nombre_vehiculo

string

optional

Filtrar por nombre del vehículo (búsqueda parcial)

Example:

Toyota

marca

string

optional

Filtrar por marca del vehículo

Example:

Toyota

linea

string

optional

Filtrar por línea del vehículo

Example:

Corolla

tipos

string

optional

Filtrar por tipo de vehículo

Example:

sedan

capacidad_min

integer

optional

Capacidad mínima de pasajeros

>= 1

Example:

capacidad_max

integer

optional

Capacidad máxima de pasajeros

>= 1

Example:

blindaje

enum<string>

optional

Filtrar por vehículos blindados

Allowed values:

truefalse

Example:

false

estado

enum<string>

optional

Filtrar por estado del vehículo

Allowed values:

activoinactivo

Example:

activo

pagina

integer

optional

Número de página para la paginación

>= 1

Default:

Example:

limite

integer

optional

Número de registros por página (máximo 60)

>= 1<= 60

Default:

Example:

Responses

🟢200OK

application/json

Lista de vehículos obtenida exitosamente

Body

resultado

enum<string>

optional

Resultado de la operación

Allowed value:

Example:

datos

array[object (Vehiculo) {12}]

optional

Lista de vehículos del catálogo

integer

optional

ID único del vehículo en el catálogo

Example:

nombre_vehiculo

string

optional

Nombre descriptivo del vehículo

Example:

Toyota Corolla 2024

modelo

string

optional

Año del modelo del vehículo

Example:

2024

marca

string

optional

Marca del vehículo

Example:

Toyota

linea

string

optional

Línea del vehículo

Example:

Corolla

tipos

string

optional

Tipo del vehículo

Example:

sedan

url_imagen

string | null

optional

URL de la imagen del vehículo

Example:

https://ejemplo.com/imagenes/toyota-corolla.jpg

capacidad

integer

optional

Capacidad de pasajeros

Example:

blindaje

boolean

optional

Indica si es blindado

Example:

false

estado

enum<string>

optional

Estado del vehículo

Allowed values:

activoinactivo

Example:

activo

created_at

string <date-time>

optional

Fecha y hora de creación

Example:

2024-12-15T10:30:00.000Z

updated_at

string <date-time>

optional

Fecha y hora de última actualización

Example:

2024-12-15T10:30:00.000Z

paginacion

object (Paginacion)

optional

pagina_actual

integer

optional

Página actual

Example:

total_paginas

integer

optional

Total de páginas disponibles

Example:

total_registros

integer

optional

Total de registros encontrados

Example:

limite

integer

optional

Número de registros por página

Example:

tiene_anterior

boolean

optional

Indica si hay página anterior

Example:

false

tiene_siguiente

boolean

optional

Indica si hay página siguiente

Example:

true

Examples

Lista con vehículosLista vacía

{
    "resultado": "OK",
    "datos": [
        {
            "id": 1,
            "nombre_vehiculo": "Toyota Corolla 2024",
            "modelo": "2024",
            "marca": "Toyota",
            "linea": "Corolla",
            "tipos": "sedan",
            "url_imagen": null,
            "capacidad": 5,
            "blindaje": false,
            "estado": "activo",
            "created_at": "2024-12-15T10:30:00.000Z",
            "updated_at": "2024-12-15T10:30:00.000Z"
        },
        {
            "id": 2,
            "nombre_vehiculo": "Mercedes Sprinter Blindada",
            "modelo": "2023",
            "marca": "Mercedes-Benz",
            "linea": "Sprinter",
            "tipos": "van",
            "url_imagen": "https://ejemplo.com/imagenes/sprinter-blindada.jpg",
            "capacidad": 12,
            "blindaje": true,
            "estado": "activo",
            "created_at": "2024-12-15T11:00:00.000Z",
            "updated_at": "2024-12-15T11:00:00.000Z"
        }
    ],
    "paginacion": {
        "pagina_actual": 1,
        "total_paginas": 1,
        "total_registros": 2,
        "limite": 10,
        "tiene_anterior": false,
        "tiene_siguiente": false
    }
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Listar vehículos del catálogo

Request

Request samples

Responses