文档首页/ 路网数字化服务 DRIS/ API参考/ API/ 应用侧API参考/ 车辆管理/ 创建车辆
更新时间：2024-10-24 GMT+08:00
查看PDF
分享

创建车辆

功能介绍

创建车辆

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/vehicles

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。

取值范围：仅支持数字，a到f的小写字母组合，长度32。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Instance-Id

否

String

参数说明：实例ID。DRIS物理实例的唯一标识，获取方法请参见“API参考 > 附录 > 获取Instance-Id”。

取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。

X-Auth-Token

否

String

参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 “获取IAM用户Token”接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见“API参考 > API > 应用侧API参考 > 如何调用API > 认证鉴权 > Token认证”。
表3 请求Body参数

参数

是否必选

参数类型

描述

vehicle_id

是

String

参数说明：车辆唯一标识符。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

plate_no

否

String

参数说明：车牌号。

取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。

vin

否

String

参数说明：VIN码，车辆的17位VIN码。

取值范围：长度不超过17，只允许字母、数字字符的组合。

obu_id

否

String

参数说明：车载OBU的唯一标识。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

imei

否

String

参数说明：IMEI，OBU上电子序列号。

取值范围：长度最小1最大255，支持纯数字的组合。

brand

否

String

参数说明：车辆品牌。

取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。

model

否

String

参数说明：车牌型号。

取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。

style

否

String

参数说明：车辆年款。

取值范围：长度最小1最大64，支持纯数字的组合。

fuel_type

否

String

参数说明：定义车辆的燃料动力类。

取值范围：

  • unknownFuel：未知

  • gasoline：汽油

  • ethanol：乙醇

  • diesel：柴油

  • electric：电动

  • hybrid：混合燃料类型

  • hydrogen：氢气

  • natGasLiquid：液化天然气

  • natGasComp：压缩天然气

  • propane：丙烷

color

否

String

参数说明：车辆颜色。

取值范围：

  • black：黑色

  • white：白色

  • gray：灰色

  • red：红色

  • blue：蓝色

  • yellow：黄色

  • orange：橙色

  • brown：棕色

  • green：绿色

  • purple：紫色

  • cyan：青色

  • pink：粉红色

  • transparent：透明色

  • other：其他

plate_color

否

String

参数说明：车辆颜色。

取值范围：

  • black：黑色

  • white：白色

  • blue：蓝色

  • yellow：黄色

  • green：绿色

access_type

否

String

参数说明：车辆接入网络的方式。

取值范围：

  • 5g

  • 4g

  • 3g

  • 2g

  • pc5Only

  • pc5And5g

  • pc5And4g

  • pc5And3g

  • pc5And2g

secret

是

String

参数说明：第三方车辆密钥，输入车辆型号ID后方可填写该字段以设置方车辆密码。

description

否

String

参数说明：描述。

取值范围：长度不超过2048，只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。

响应参数

状态码： 201

表4 响应Body参数

参数

参数类型

描述

vehicle_id

String

参数说明：车辆唯一标识符。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

plate_no

String

参数说明：车牌号。

取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。

vin

String

参数说明：VIN码，车辆的17位VIN码。

取值范围：长度不超过17，只允许字母、数字字符的组合。

obu_id

String

"参数说明：车载OBU的唯一标识。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

imei

String

参数说明：IMEI，OBU上电子序列号。

取值范围：长度最小1最大255，支持纯数字的组合。

brand

String

参数说明：车辆品牌。

取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。

model

String

参数说明：车牌型号。

取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。

style

String

参数说明：车辆年款。

取值范围：长度最小1最大64，支持纯数字的组合。

fuel_type

String

参数说明：定义车辆的燃料动力类。

取值范围：

  • unknownFuel：未知

  • gasoline：汽油

  • ethanol：乙醇

  • diesel：柴油

  • electric：电动

  • hybrid：混合燃料类型

  • hydrogen：氢气

  • natGasLiquid：液化天然气

  • natGasComp：压缩天然气

  • propane：丙烷

color

String

参数说明：车辆颜色。

取值范围：

  • black：黑色

  • white：白色

  • gray：灰色

  • red：红色

  • blue：蓝色

  • yellow：黄色

  • orange：橙色

  • brown：棕色

  • green：绿色

  • purple：紫色

  • cyan：青色

  • pink：粉红色

  • transparent：透明色

  • other：其他

plate_color

String

参数说明：车辆颜色。

取值范围：

  • black：黑色

  • white：白色

  • blue：蓝色

  • yellow：黄色

  • green：绿色

access_type

String

参数说明：车辆接入网络的方式。

取值范围：

  • 5g

  • 4g

  • 3g

  • 2g

  • pc5Only

  • pc5And5g

  • pc5And4g

  • pc5And3g

  • pc5And2g

description

String

参数说明：描述。

取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。

last_modified_time

String

参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

created_time

String

参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

last_online_time

String

参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

status

String

参数说明：设备状态。

取值范围：

  • ONLINE：在线

  • OFFLINE：离线

  • INITIAL：初始化

请求示例

POST https://{endpoint}/v1/{project_id}/vehicles
Content-Type:application/json
X-Auth-Token:********
Instance-Id:********

{
  "vehicle_id" : "13229397084005974033576909202199",
  "plate_no" : "粤B12345",
  "vin" : "vin121456",
  "obu_id" : "112412",
  "imei" : "2313523162",
  "brand" : "polo",
  "model" : "model",
  "style" : "2020",
  "fuel_type" : "gasoline",
  "color" : "blue",
  "plate_color" : "black",
  "access_type" : "5g",
  "secret" : "secret123456",
  "description" : "description"
}

响应示例

状态码： 201

Created

{
  "vehicle_id" : "13229397084005974033576909202199",
  "plate_no" : "粤B12345",
  "vin" : "vin121456",
  "obu_id" : "112412",
  "imei" : "2313523162",
  "brand" : "polo",
  "model" : "model",
  "style" : "2020",
  "fuel_type" : "gasoline",
  "color" : "blue",
  "plate_color" : "black",
  "access_type" : "5g",
  "description" : "description",
  "status" : "INITIAL",
  "created_time" : "2022-01-06T09:30:24Z"
}

状态码

状态码

描述

201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Method Not Allowed

409

Conflict

429

Too Many Requests

500

Internal Server Error

错误码

请参见错误码。

父主题： 车辆管理

相关文档