Saltar al contenido principal

Obtener tipos de vehículos visibles

GET 
/

Este endpoint devuelve una lista paginada de los tipos de vehículos visibles en el sistema.

Funcionalidad:

  • Filtra solo los tipos de vehículos marcados como visibles
  • Soporta paginación con parámetros estándar (limit, page)
  • Permite ordenar por placa del vehículo
  • Devuelve información básica como tipo de vehículo, placa, imagen e ITV

Casos de uso:

  1. Listar vehículos disponibles para asignar a transportistas
  2. Mostrar opciones de vehículos en formularios de creación
  3. Integración con apps móviles para mostrar flota disponible

Ejemplo de respuesta:

{
  "docs": [
    {
      "_id": "60a1b2c3d4e5f67890123456",
      "code": "TRUCK",
      "name": "Camión",
      "description": "Vehículo pesado para transporte de mercancías",
      "visible": true,
      "createdAt": "2023-05-15T10:30:00Z",
      "updatedAt": "2023-05-15T10:30:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "page": 1,
  "pages": 1
}

Responses​

Respuesta exitosa que contiene una lista paginada de tipos de vehículos.

Formato de respuesta:

  • Siempre devuelve un objeto con la estructura de paginación
  • Incluso para resultados vacíos, devuelve el objeto con docs=[]

Códigos de estado alternativos:

  • 400: Error en parámetros de consulta
  • 401: No autorizado (token JWT inválido o expirado)
  • 500: Error interno del servidor

Ejemplo de error:

{
  "error": "Invalid token",
  "message": "The authentication token is invalid or expired",
  "statusCode": 401
}