华为云用户手册

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 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：初始化

响应示例 状态码： 201 Created { "count" : 1, "edge_apps" : [ { "edge_app_id" : "14729446815072419760762234026232", "description" : "this is a test", "created_time" : "2021-12-23T12:29:08Z", "last_modified_time" : "2021-12-23T12:29:08Z", "last_published_version" : null } ] }

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明：用户自定义应用唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）、美元符号（$）的组合。 最小长度：1 最大长度：32 description String 参数说明：应用描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。 最小长度：0 最大长度：255 created_time String 参数说明：创建时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z。 最小长度：0 最大长度：255 last_modified_time String 参数说明：更新时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z。 最小长度：0 最大长度：255 last_published_version String 参数说明：最新发布版本。 最小长度：0 最大长度：64

请求示例 POST https://{endpoint}/v1/{project_id}/v2x-edge-apps Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "edge_app_id" : "14729446815072419760762234026232", "description" : "this is a test" }

请求示例 GET https://{endpoint}/v1/{project_id}/traffic-controllers?limit={limit}&offset={offset}&status={status}&esn={esn}&traffic_controller_id={traffic_controller_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:********"

响应示例 状态码： 200 OK { "count" : 1, "traffic_controller_devices" : [ { "traffic_controller_id" : "13229397084005974033576909202199", "esn" : "17598448011929637214623971962555", "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road1", "link_id" : "12345676", "status" : "INITIAL", "last_modified_time" : "2022-01-06T09:30:24Z", "created_time" : "2022-01-06T09:30:24Z", "last_online_time" : null } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：返回信号机设备的总体数量。 最小值：0 最大值：2147483647 traffic_controller_devices Array of TrafficControllerDTO objects 参数说明：数据列表。 数组长度：0 - 2147483647 表5 TrafficControllerDTO 参数 参数类型 描述 traffic_controller_id String 参数说明：信号机设备ID，全局唯一。 最小长度：1 最大长度：128 esn String 参数说明：序列号。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 name String 参数说明：名称。 最大长度：128 description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 最大长度：2048 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 最小值：-180 最大值：180 ele Number 参数说明：定义海拔高程，可选，单位为分米。 最小值：-4095 最大值：61439 pos_description String 参数说明：位置说明。 取值范围：长度不超过128，只允许字母、数字、以及_等字符的组合。 最大长度：128 installation_mode String 参数说明：架设方式。 取值范围： columnar：柱式 road-side-attach：路侧附着式 cantilever：悬臂式 gantry：门架式 lane-above-attach：车行道上方附着式 road_name String 参数说明：所属道路名称，比如高速名称。 取值范围：长度不超过64，只允许汉字、字母、数字、以及_-等字符的组合。 最小长度：1 最大长度：64 link_id String 参数说明：信号机设备所属路段ID。 取值范围：长度等于30，只允许大写字母、数字。 status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 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

请求示例 PUT https://{endpoint}/v1/{project_id}/traffic-controllers/{traffic_controller_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road2", "link_id" : "12345678" }

响应示例 状态码： 200 OK { "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road2", "link_id" : "12345678", "status" : "INITIAL", "last_modified_time" : "2022-01-06T09:30:24Z", "created_time" : "2022-01-06T09:30:24Z", "last_online_time" : null }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 traffic_controller_id String 参数说明：信号机设备ID，全局唯一。 最小长度：1 最大长度：128 esn String 参数说明：序列号。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 name String 参数说明：名称。 最大长度：128 description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 最大长度：2048 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 最小值：-180 最大值：180 ele Number 参数说明：定义海拔高程，可选，单位为分米。 最小值：-4095 最大值：61439 pos_description String 参数说明：位置说明。 取值范围：长度不超过128，只允许字母、数字、以及_等字符的组合。 最大长度：128 installation_mode String 参数说明：架设方式。 取值范围： columnar：柱式 road-side-attach：路侧附着式 cantilever：悬臂式 gantry：门架式 lane-above-attach：车行道上方附着式 road_name String 参数说明：所属道路名称，比如高速名称。 取值范围：长度不超过64，只允许汉字、字母、数字、以及_-等字符的组合。 最小长度：1 最大长度：64 link_id String 参数说明：信号机设备所属路段ID。 取值范围：长度等于30，只允许大写字母、数字。 status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：返回RSU的总体数量。 最小值：0 最大值：100000 rsus Array of RsuDTO objects 参数说明：RSU数据列表。 数组长度：0 - 2147483647 表5 RsuDTO 参数 参数类型 描述 rsu_id String 参数说明：RSU的唯一标识符，在平台创建RSU时由平台生成。 最小长度：0 最大长度：255 name String 参数说明：RSU的名字。 取值范围：长度不低于1不超过128，只允许中文、字母、数字、下划线（_）、连接符（-）的组合。 description String 参数说明：RSU的描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文分号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）、空格的组合。 最小长度：0 最大长度：255 esn String 参数说明：RSU的设备序列号。 取值范围：只允许字母、数字、下划线（_）的组合。 最小长度：1 最大长度：64 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 ip String 参数说明：RSU的IP。满足IP的格式，例如127.0.0.1。 position_description String 参数说明：安装位置编码，由用户自定义。 取值范围：长度不低于1不超过128，只允许字母、数字、下划线（_）的组合。 location RsuLocation object 参数说明：RSU的位置信息。 status String 参数说明：RSU设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 UNKNOWN：未知 rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU型号，在平台创建RSU型号后由平台分配获得，获取方法可参见 “创建RSU型号”接口。 取值范围：长度不低于1不超过36，只允许字母、数字、连接符（-）的组合。 intersection_id String 参数说明：在地图中，rsu所在区域对应的路口ID，也即区域ID拼接路口ID，格式为：region-node_id。其中路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。 最小长度：0 最大长度：36 related_edge_num Integer 参数说明：RSU可关联的Edge的数量。 最小值：0 最大值：64 software_version String 参数说明：RSU的软件版本，由RSU上报其软件版本。 最小长度：0 最大长度：255 表6 RsuLocation 参数 参数类型 描述 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 最小值：-180 最大值：180

响应示例 状态码： 200 OK { "count" : 1, "rsus" : [ { "rsu_id" : "b58efc27-a6e5-4bca-9d12-c76ecfe3f102", "name" : "RSU001", "description" : "TEST", "esn" : "13518098671442480164720973683901", "last_modified_time" : "2020-09-01T01:37:01Z", "created_time" : "2020-09-01T01:37:01Z", "last_online_time" : "2020-09-01T01:37:01Z", "ip" : "127.0.0.1", "position_description" : "K08", "location" : { "lat" : 40.1234567, "lon" : 116.1234567 }, "status" : "ONLINE", "rsu_model_id" : "27652459499824704332521974743806", "intersection_id" : "1-301", "related_edge_num" : 0, "software_version" : "V100X00XX00X325" } ] }

请求示例 GET https://{endpoint}/v1/{project_id}/rsus?limit={limit}&offset={offset}&rsu_id={rsu_id}&esn={esn}&status={status}&rsu_model_id={rsu_model_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:********

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU型号，在平台创建RSU型号后由平台分配获得。 取值范围：长度不小于1不超过36，只允许字母、数字、连接符（-）的组合。 name String 参数说明: RSU型号名称。 取值范围：长度不低于1不超过64，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 manufacturer_name String 参数说明: RSU的厂商名称。 取值范围：长度不低于1不超过32，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 description String 参数说明: RSU型号的描述信息。 取值范围：长度不低于1不超过128，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）、空格的组合。 last_modified_time String 参数说明: RSU型号更新的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z created_time String 参数说明: 在平台创建RSU型号的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z

请求示例 PUT https://{endpoint}/v1/{project_id}/rsu-models/{rsu_model_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "manufacturer_name" : "ABC", "description" : "excellent" }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 platform_type String 参数说明：平台类型。 取值范围： DRIS：华为路网数字化平台 LITONG：利通 ZHONGQIYAN：中汽研 platform_para PlatformPara object 参数说明：platform_type为非DRIS时有效，表示第三方平台的对接参数 channel_status String 参数说明：华为路网数字化平台或第三方业务平台连接状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表6 PlatformPara 参数 参数类型 描述 address String 参数说明：第三方业务平台的ip地址和端口。 username String 参数说明：鉴权用户名。 取值范围：长度不超过255，只允许字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 passwd String 参数说明：鉴权密码，ITS800或者ATLAS500的密码 取值范围：长度不超过255，只允许字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。

请求示例 POST https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channel Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "platform_type" : "DRIS", "platform_para" : { "address" : "127.0.0.1:8080", "username" : "username", "passwd" : "password" } }

响应示例 状态码： 200 OK { "count" : 1, "statistics" : [ { "source" : { "source_type" : "detection", "source_id" : "EDGE0123456789" }, "section_id" : 1, "time" : "2022-09-01T13:10:21Z", "period" : 300, "direction" : 180.5, "flow" : 50, "average_speed" : 70.8, "esn" : "2102312ETX10K7000037", "cross_id" : "cross0123456789", "segment" : { "segment_id" : "1", "lon" : 114.23256, "lat" : 30.121545 }, "traffic_direction" : 0, "road_kind" : 10, "lane_count" : 4, "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 70.8 } ], "lane_flow" : [ { "lane_id" : 10, "flow" : 50, "average_speed" : 73.6, "vehicle_density" : 100, "head_interval" : 100, "space_interval" : 1000 } ], "occupancy" : [ { "lane_id" : 1, "space_occupancy" : 1, "time_occupancy" : 1 } ] } ] }

请求示例 GET https://{endpoint}/v1/{project_id}/edge-flow?limit={limit}&offset={offset}&from_date={from_date}&to_date={to_date}&edge_id={edge_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:********

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明：用户自定义应用唯一ID。 最小长度：0 最大长度：32 version String 参数说明：应用版本。 最小长度：0 最大长度：32 description String 参数说明：应用描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。 最小长度：0 最大长度：255 created_time String 参数说明：创建时间。 最小长度：0 最大长度：255 last_modified_time String 参数说明：最后一次修改时间。 最小长度：0 最大长度：255 state String 参数说明：应用版本状态。 取值范围： DRAFT：草稿 PUBLISHED：发布 OFF_SHELF：下线 publish_time String 参数说明：发布时间。 最小长度：0 最大长度：255 off_shelf_time String 参数说明：下线时间。 最小长度：0 最大长度：255

响应示例 状态码： 200 OK { "edge_app_id" : "16993214329224629859639932733105", "version" : "1.0.0", "description" : "hello", "created_time" : null, "last_modified_time" : null, "state" : "OFF_SHELF", "publish_time" : null, "off_shelf_time" : null }

响应示例 状态码： 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" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 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/json X-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 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：总记录数。 最小值：0 最大值：1000000 edge_apps Array of QueryApplicationBriefResponseDTO objects 参数说明：列举每条记录。 数组长度：0 - 1000000 表5 QueryApplicationBriefResponseDTO 参数 参数类型 描述 edge_app_id String 参数说明：用户自定义应用唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）、美元符号（$）的组合。 最小长度：1 最大长度：32 description String 参数说明：应用描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。 最小长度：0 最大长度：255 created_time String 参数说明：创建时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z。 最小长度：0 最大长度：255 last_modified_time String 参数说明：更新时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z。 最小长度：0 最大长度：255 last_published_version String 参数说明：最新发布版本。 最小长度：0 最大长度：64

响应示例 状态码： 200 OK { "count" : 1, "edge_apps" : [ { "edge_app_id" : "10691172132537970614092038885766", "description" : "this is a test app", "created_time" : "2021-12-23T12:21:55", "last_modified_time" : "2021-12-23T12:21:55", "last_published_version" : null } ] }

响应示例 状态码： 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：初始化

响应示例 状态码： 200 OK { "rsu_model_id" : "5ba24f5ebbe8f56f5a14f605", "name" : "RSU001", "manufacturer_name" : "ABC", "description" : "excellent", "created_time" : "2020-12-07T01:32:17Z", "last_modified_time" : "2020-12-07T01:32:17Z" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU型号，在平台创建RSU型号后由平台分配获得。 取值范围：长度不小于1不超过36，只允许字母、数字、连接符（-）的组合。 name String 参数说明: RSU型号名称。 取值范围：长度不低于1不超过64，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 manufacturer_name String 参数说明: RSU的厂商名称。 取值范围：长度不低于1不超过32，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 description String 参数说明: RSU型号的描述信息。 取值范围：长度不低于1不超过128，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）、空格的组合 last_modified_time String 参数说明: RSU型号更新的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z created_time String 参数说明: 在平台创建RSU型号的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z