Skip to main content

​
Vehiculos API

Manage vehicle records including makes, models, images, and categories.

​
Vehicle Object

​
id_vehiculo
integer
required
Unique identifier for the vehicle (auto-generated primary key)
​
placa
string
required
Vehicle license plate number (max 7 characters)
​
id_marca
integer
required
Foreign key reference to MarcasVehiculos (vehicle make)
​
id_modelo
integer
required
Foreign key reference to ModelosVehiculos (vehicle model)
​
anio
integer
required
Year of manufacture
​
categoria_vehiculo
string
required
Vehicle category. Must be one of:
  • sedan - Sedan
  • suv - SUV
  • camioneta - Pickup truck
  • camion - Truck
  • bus - Bus
​
color_vehiculo
string
required
Vehicle color (max 20 characters)

​
Vehicle Images

​
imagen_izq
image
Left side view photo (uploaded to media/)
​
imagen_der
image
Right side view photo (uploaded to media/)
​
imagen_frontal
image
Front view photo (uploaded to media/)
​
imagen_trasera
image
Rear/back view photo (uploaded to media/)
​
imagen_techo
image
Roof/top view photo (uploaded to media/)

​
Relationships

​
id_usuario
integer
Foreign key to Usuario (nullable)
​
id_chofer
integer
Foreign key to Chofer/driver (nullable)
​
id_cliente
integer
Foreign key to Cliente/client (nullable)
​
estado
integer
required
Vehicle status/state

​
GET /api/vehiculos

Retrieve a list of all vehicles.

​
Query Parameters

​
categoria_vehiculo
string
Filter by vehicle category (sedan, suv, camioneta, camion, bus)
​
id_marca
integer
Filter by vehicle make ID
​
id_modelo
integer
Filter by vehicle model ID
​
placa
string
Filter by license plate
​
estado
integer
Filter by status

​
Response

[
  {
    "id_vehiculo": 1,
    "placa": "ABC1234",
    "id_marca": 5,
    "id_modelo": 12,
    "anio": 2022,
    "categoria_vehiculo": "sedan",
    "color_vehiculo": "Negro",
    "imagen_izq": "/media/vehicle_left_1.jpg",
    "imagen_der": "/media/vehicle_right_1.jpg",
    "imagen_frontal": "/media/vehicle_front_1.jpg",
    "imagen_trasera": "/media/vehicle_back_1.jpg",
    "imagen_techo": "/media/vehicle_roof_1.jpg",
    "id_usuario": 45,
    "id_chofer": 23,
    "id_cliente": null,
    "estado": 1
  },
  {
    "id_vehiculo": 2,
    "placa": "XYZ5678",
    "id_marca": 8,
    "id_modelo": 34,
    "anio": 2021,
    "categoria_vehiculo": "suv",
    "color_vehiculo": "Blanco",
    "imagen_izq": "/media/vehicle_left_2.jpg",
    "imagen_der": "/media/vehicle_right_2.jpg",
    "imagen_frontal": "/media/vehicle_front_2.jpg",
    "imagen_trasera": "/media/vehicle_back_2.jpg",
    "imagen_techo": "/media/vehicle_roof_2.jpg",
    "id_usuario": 67,
    "id_chofer": 45,
    "id_cliente": 12,
    "estado": 1
  }
]

​
POST /api/vehiculos

Create a new vehicle record.

​
Request Body

​
placa
string
required
Vehicle license plate (max 7 characters)
​
id_marca
integer
required
Vehicle make ID (references MarcasVehiculos)
​
id_modelo
integer
required
Vehicle model ID (references ModelosVehiculos)
​
anio
integer
required
Year of manufacture
​
categoria_vehiculo
string
required
Vehicle category: sedan, suv, camioneta, camion, or bus
​
color_vehiculo
string
required
Vehicle color
​
imagen_izq
file
Left side view photo
​
imagen_der
file
Right side view photo
​
imagen_frontal
file
Front view photo
​
imagen_trasera
file
Rear view photo
​
imagen_techo
file
Roof view photo
​
id_usuario
integer
Associated user ID (optional)
​
id_chofer
integer
Associated driver ID (optional)
​
id_cliente
integer
Associated client ID (optional)
​
estado
integer
required
Vehicle status

​
Request Example

{
  "placa": "ABC1234",
  "id_marca": 5,
  "id_modelo": 12,
  "anio": 2022,
  "categoria_vehiculo": "sedan",
  "color_vehiculo": "Negro",
  "id_usuario": 45,
  "id_chofer": 23,
  "estado": 1
}

​
Response

{
  "id_vehiculo": 1,
  "placa": "ABC1234",
  "id_marca": 5,
  "id_modelo": 12,
  "anio": 2022,
  "categoria_vehiculo": "sedan",
  "color_vehiculo": "Negro",
  "imagen_izq": "",
  "imagen_der": "",
  "imagen_frontal": "",
  "imagen_trasera": "",
  "imagen_techo": "",
  "id_usuario": 45,
  "id_chofer": 23,
  "id_cliente": null,
  "estado": 1
}

​
Vehicle Categories

The system supports five vehicle categories:
ValueDisplay NameDescription
sedanSedanStandard passenger car
suvSUVSport utility vehicle
camionetaCamionetaPickup truck
camionCamionLarge truck
busBusPassenger bus

Build docs developers (and LLMs) love

Get started for freeTalk to us