Crear vehiculo

[ POST ]

En esta ruta se podrá crear un recurso de tipo Vehículo. Es importante ver las diferentes opciones que las variables pueden tomar ya que estas serán utilizadas por el planeador de rutas para hacer ruteo por dimensiones.

https://sync.airbagtech.io/vehicle

Campos

Nombre	Tipo	Requerido	Descripción
id	String	Si	ID del vehículo que desea crear. Este valor es sumamente importante ya que se utilizara para identificar a este recurso en nuestro sistema.
name	String	Si	Nombre a mostrar en la aplicación móvil y web.
plate	String	Si	Placas legales del vehículo.
vehicleType	String	No	Categoría del vehiculo. Este campo será utilizado para el ruteo por dimensiones. Debe ser uno de los valores válidos listados en la sección Vehiculos
brand	String	No	Marca del vehiculo. Debe ser uno de los valores válidos listados en la sección Vehiculos, por ejemplo Toyota.
model	String	No	Modelo del vehiculo (texto libre).
fuelType	String	No	Tipo de combustible del vehículo. Debe ser uno de los valores válidos listados en la sección Vehiculos
niv	String	No	Número identificador oficial del vehículo.
color	String	No	Color del vehiculo.
description	String	No	Descripción del vehiculo.
policyNumber	String	No	Número de póliza otorgado por el Carrier.
insuranceCarrier	String	No	Aseguradora que protege a dicho vehiculo. Debe ser uno de los valores válidos listados en la sección Vehiculos
insuranceExpiration	String	No	Fecha de expiración del seguro. Notificaremos a la empresa cuando sea cercana la fecha. Formato YYYY-MM-DD
height	Number	No	Altura del vehiculo en metros. Pasar en caso de escoger 'Otro' en vehicleType
length	Number	No	Longitud del vehículo en metros. Pasar en caso de escoger 'Otro' en vehicleType
width	Number	No	Ancho del vehiculo en metros. Pasar en caso de escoger 'Otro' en vehicleType.
driverId	String	No	ID del conductor que usará el vehículo. Acepta el ID que tu empresa usó al crear el conductor o el airbagId.

warning

Por ahora insuranceExpiration y driverId se aceptan pero no se guardan: el seguro queda sin fecha de expiración y el vehículo sin conductor asignado. Se está corrigiendo; mientras tanto, captúralos desde la plataforma de Airbag.

Headers

Content-Type	Authorization
application/json	apikey {{API_KEY}}

Body

{
  "vehicle": {
    "id": "string",
    "plate": "string",
    "name": "string",
    "vehicleType": "string",
    "brand": "string",
    "model": "string",
    "fuelType": "string",
    "niv": "string",
    "color": "string",
    "description": "string",
    "policyNumber": "string",
    "insuranceCarrier": "string",
    "insuranceExpiration": "string",
    "height": 0,
    "length": 0,
    "width": 0,
    "driverId": "string"
  }
}

Ejemplo

curl --location 'https://sync.airbagtech.io/vehicle' \
--header 'Content-Type: application/json' \
--header 'Authorization: apikey {{API_KEY}}' \
--data '{
    "vehicle": {
        "id": "string",
        "plate": "string",
        "name": "string",
        "vehicleType": "string",
        "brand": "string",
        "model": "string",
        "fuelType": "string",
        "niv": "string",
        "color": "string",
        "description": "string",
        "policyNumber": "string",
        "insuranceCarrier": "string",
        "insuranceExpiration": "string",
        "height": 0,
        "length": 0,
        "width": 0,
        "driverId": "string"
    }
}'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve los campos enviados que la API aceptó, tal como se enviaron.

warning

Por ahora la respuesta no incluye el airbagId del vehículo creado. Se está corrigiendo; mientras tanto, consúltalo con Consultar vehículo usando tu id.

{
  "status": true,
  "vehicle": {
    "id": "VH-001",
    "plate": "ABC1234",
    "name": "Unidad 1",
    "vehicleType": "s-vehicle",
    "brand": "Toyota",
    "model": "Corolla",
    "fuelType": "gas",
    "driverId": "1234"
  }
}

Campo	Tipo	Descripción
status	Boolean	true si el vehículo se creó.
vehicle	Object	Los campos del cuerpo de la solicitud que la API aceptó, tal como se enviaron.

❌ Respuesta con error (400 Bad Request)

Se devuelve cuando un campo no es válido o el cuerpo incluye campos no permitidos.

{
  "status": false,
  "message": "Error: Vehicle Params have unknown parameters: color2",
  "errorId": "sentry_error_id_123"
}