云服务器内容精选

  • 响应示例 状态码: 200 OK { "count" : 1, "vehicles" : [ { "vehicle_id" : "12302463411926825917269660281057", "plate_no" : "Huawei", "vin" : "74512845126", "obu_id" : "OBU_007", "imei" : "987954asdfasdf", "brand" : "Huawei", "model" : "Huawei", "style" : "2022", "fuel_type" : "gasoline", "color" : "white", "plate_color" : "black", "access_type" : "5g", "description" : "description", "last_modified_time" : "2020-09-01T01:37:01Z", "created_time" : "2020-09-01T01:37:01Z", "last_online_time" : "2020-11-01T01:37:01Z", "status" : "OFFLINE" } ] }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明:返回车辆的总体数量。 最小值:0 最大值:2147483647 vehicles Array of VehicleDTO objects 参数说明:数据列表。 数组长度:0 - 2147483647 表5 VehicleDTO 参数 参数类型 描述 vehicle_id String 参数说明:车辆唯一标识符。 取值范围:长度不超过128,只允许字母、数字、以及_-等字符的组合。 plate_no String 参数说明:车牌号。 取值范围:长度最小1最大64,支持中文、阿拉伯文、字母、数字、下划线(_)、横杠(-)的组合。 vin String 参数说明:VIN码,车辆的17位VIN码。 取值范围:长度不超过17,只允许字母、数字字符的组合。 最大长度: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,只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 最大长度: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:初始化
  • 请求示例 PUT https://{endpoint}/v1/{project_id}/vehicles/{vehicle_id}Content-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "imei" : "imei", "brand" : "polo", "model" : "model", "style" : "2020", "fuel_type" : "gasoline", "color" : "blue", "plate_color" : "black", "access_type" : "5g", "description" : "description"}
  • 响应示例 状态码: 200 OK { "vehicle_id" : "13229397084005974033576909202199", "plate_no" : "粤B12345", "vin" : "vin121456", "obu_id" : "112412", "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"}