Crear vehículo en catálogo

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

nombre_vehiculo

string

required

Nombre descriptivo único del vehículo

>= 1 characters<= 255 characters

Example:

Toyota Corolla 2024

modelo

string

required

Año del modelo del vehículo

>= 1 characters<= 50 characters

Example:

2024

marca

string

required

Marca del vehículo

>= 1 characters<= 100 characters

Example:

Toyota

linea

string

required

Línea o modelo específico del vehículo

>= 1 characters<= 100 characters

Example:

Corolla

tipos

string

required

Tipo o categoría del vehículo (sedan, suv, van, etc.)

>= 1 characters<= 50 characters

Example:

sedan

url_imagen

string <uri> | null

optional

URL de la imagen del vehículo (opcional)

Example:

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

capacidad

integer

required

Capacidad máxima de pasajeros

>= 1<= 100

Example:

5

blindaje

boolean

optional

Indica si el vehículo es blindado

Default:

false

Example:

false

estado

enum<string>

optional

Estado del vehículo en el catálogo

Allowed values:

activoinactivo

Default:

activo

Example:

activo

Examples

Vehículo básicoVehículo blindado con imagenExample 3

{
    "nombre_vehiculo": "Toyota Corolla 2024",
    "modelo": "2024",
    "marca": "Toyota",
    "linea": "Corolla",
    "tipos": "sedan",
    "capacidad": 5,
    "blindaje": false,
    "estado": "DISPONIBLE"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURL

Vehículo básicoVehículo blindado con imagenExample 3

curl --location --request POST '/api/v1/catalogo-vehiculos' \
--header 'Content-Type: application/json' \
--data-raw '{
    "nombre_vehiculo": "Toyota Corolla 2024",
    "modelo": "2024",
    "marca": "Toyota",
    "linea": "Corolla",
    "tipos": "sedan",
    "capacidad": 5,
    "blindaje": false,
    "estado": "DISPONIBLE"
}'

Responses

🟢200OK

application/json

Vehículo creado exitosamente

Body

resultado

enum<string>

optional

Resultado de la operación

Allowed value:

OK

Example:

OK

datos

object (Vehiculo)

optional

id

integer

optional

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

Example:

1

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:

5

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

mensaje

string

optional

Mensaje descriptivo de la operación

Example:

Vehículo creado exitosamente en el catálogo

Example

{
    "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": "DISPONIBLE"
    },
    "mensaje": "Vehículo creado exitosamente en el catálogo"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error