命令下发 | 飞思物联IOT平台

# 命令下发

# 命令下发流程

# 平台下发命令

请求URL：/iot/tx/deviceControl
请求方式：POST
请求头：

参数名称	变量	类型[长度限制]	必填	描述
命令唯一码	uuid	String[1,16]	是	平台生成的命令uuid
下发时间	timestamp	String[1,32]	是	命令下发时间
设备通讯地址	deviceAddr	String[1,64]	是	在平台创建设备时填入的通讯地址
命令类型	cmdType			yk=遥控 yc=遥调 allcall=查询设备数据
命令数据	cmdItems

变量cmdItems数据参数：

参数名称	变量	类型[长度限制]	必填	描述
属性唯一标识	identifier	String[1,128]	是	设备属性的唯一标识
属性值	value	String	是	属性值

请求示例：

{
  "uuid":"d6919804-bb12-47db-b925-c1185a43971e",
  "timestamp":"1620791347000",
  "deviceAddr":"100000000000001",
  "cmdType":"yk",
  "cmdItems":[
    {"identifier":"10001","value":"0"}
  ]
}

1
2
3
4
5
6
7
8
9

返回参数：

参数名称	变量	类型[长度限制]	必填	描述
状态码	code	int[1,4]	是
错误码	msg	String[1,32]	是

返回示例:

{
    "code":200,
    "msg":"SUCCESS"
}

1
2
3
4

错误码：

状态码	错误码	描述	解决方案
401	INVALID_TOKEN	无效的token	请先请求设备登录接口

# 设备上送命令执行结果

请求URL：/iot/rx/controlResult
请求方式：POST
请求头：

参数名称	变量	类型[长度限制]	必填	描述
授权令牌	token	String[1,32]	是	设备登录时获取的TOKEN

请求参数：

参数名称	变量	类型[长度限制]	必填	描述
命令唯一标识	uuid	String[1,16]	是	应与收到平台下发命令时的uuid一致
命令执行结果	result	String[1-16]	是	反馈给平台的命令执行结果：’success’,’fail’,’unknown’

请求示例：

{
  "uuid":"d6919804-bb12-47db-b925-c1185a43971e",
  "result":"SUCCESS"
}

1
2
3
4

返回参数：

参数名称	变量	类型[长度限制]	必填	描述
状态码	code	int[1,4]	是
错误码	msg	String[1,32]	是

返回示例:

{
    "code":200,
    "msg":"SUCCESS"
}

1
2
3
4

错误码：

状态码	错误码	描述	解决方案
401	INVALID_TOKEN	无效的token	请先请求设备登录接口