文档首页 > > API参考> API> RESTFUL接口> 发布远程控制命令 AddCommand

发布远程控制命令 AddCommand

分享
更新时间:2020/04/27 GMT+08:00

功能介绍

车企/TSP平台向车联网服务下发远程控制命令,实现对车辆远程控制

URI

POST BaseUrl/v1/{project_id}/ociov/{ociov_id}/vehicle-commands

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

project_id

ociov_id

String

ociov_id

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

vehicle_id

String

车ID。

vin

String

车架号。

device_id

String

命令接收设备ID,比如TBox的device_id。

command

String

车命令,如:

  • CTRL_DOOR

  • CTRL_WINDOW

  • CTRL_SUNROOF

  • CTRL_LIGHT_HORN

  • CTRL_SEAT

  • CTRL_HVAC

  • CTRL_BATTERY_HEAT

  • CTRL_BATTERY_CHARGE

req_paras

ReqParasDTO

请求命令具体参数

expire_in

Integer

过期时间,单位:秒。

wake_up

Boolean

如果车未启动,是否唤醒。

表3 CtrlDoorDTO

参数

是否必选

参数类型

描述

door

String

车门。

取值范围:

  • OPEN

  • CLOSE

rear

String

尾门。

取值范围:

  • OPEN

  • CLOSE

rear_lock

String

后备箱锁。

取值范围:

  • LOCK

  • UNLOCK

left_front

String

左前车门。

取值范围:

  • OPEN

  • CLOSE

right_front

String

右前车门。

取值范围:

  • OPEN

  • CLOSE

left_back

String

左后车门。

取值范围:

  • OPEN

  • CLOSE

right_back

String

右后车门。

取值范围:

  • OPEN

  • CLOSE

bonnet

String

引擎盖。

取值范围:

  • OPEN

  • CLOSE

ignor_preconditions

String

忽略解锁条件。

取值范围:

  • TRUE

  • FALSE

timestamp

String

-

响应参数

状态码为 201 时:

表4 响应Body参数

参数

参数类型

描述

project_id

String

项目ID。

ociov_id

String

车联网服务ID。

vehicle_command_id

String

车命令ID。

vin

String

车架号。

device_id

String

命令接收设备ID,比如TBox的device_id。

command

String

车命令, 如:

  • CTRL_DOOR

  • CTRL_WINDOW

  • CTRL_SUNROOF

  • CTRL_LIGHT_HORN

  • CTRL_SEAT

  • CTRL_HVAC

  • CTRL_BATTERY_HEAT

  • CTRL_BATTERY_CHARGE

req_paras

ReqParasDTO

-

expire_in

Integer

过期时间,单位:秒。

wake_up

Boolean

如果车未启动,是否唤醒。

rsp_result

RspResultDTO

-

status

String

车命令状态: 挂起(由于车未连接网络), 已投递到TBox, TBox上报执行中, TBox上报成功完成, TBox上报执行失败, 过期未完成(过期未达到成功或失败状态), 人为取消(已投递不能取消)。

取值范围:

  • PENDING

  • DELIVERED

  • RUNNING

  • SUCCESS

  • FAILURE

  • EXPIRED

  • CANCELED

etag

Integer

首次置1,以后每次修改加1。

create_time

String

创建时间。

last_modified_time

String

最后修改时间。

请求示例

{
"vehicle_id" : "1234567890",
"vin" : "1234567890",
"device_id" : "1234567890",
"command" : "CTRL_DOOR",
"req_paras" : {
	"ctrl_door" : {
		"door" : "OPEN",
		"rear" : "OPEN",
		"rear_lock" : "LOCK",
		"left_front" : "OPEN",
		"right_front" : "OPEN",
		"left_back" : "OPEN",
		"right_back" : "OPEN",
		"bonnet" : "OPEN",
		"ignor_preconditions" : "TRUE",
		"timestamp" : "string"
	}
},
"expire_in" : 1,
"wake_up" : true
}

响应示例

状态码为 201 时:

{
"project_id" : "1234567890",
"ociov_id" : "1234567890",
"vehicle_command_id" : "1234567890",
"vin" : "1234567890",
"device_id" : "1234567890",
"command" : "CTRL_DOOR",
"req_paras" : {
	"ctrl_door" : {
		"door" : "OPEN",
		"rear" : "OPEN",
		"rear_lock" : "LOCK",
		"left_front" : "OPEN",
		"right_front" : "OPEN",
		"left_back" : "OPEN",
		"right_back" : "OPEN",
		"bonnet" : "OPEN",
		"ignor_preconditions" : "TRUE",
		"timestamp" : "string"
	}
},
"expire_in" : 1,
"wake_up" : true,
"rsp_result" : {
"data" : {
	"door" : {
		"door_status" : "OPEN",
		"rear_status" : "OPEN",
		"rear_lock_status" : "LOCK",
		"left_front_status" : "OPEN",
		"right_front_status" : "OPEN",
		"left_back_status" : "OPEN",
		"right_back_status" : "OPEN",
		"cent_lock_status" : "OPEN",
		"front_hood_status" : "OPEN"
        }
}
},
"status" : "DELIVERED",
"etag" : 1
}
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问