应用开发●API接口●命令API

发送命令/控制设备

请求方式及地址

   POST 
   http://api.nlecloud.com/Cmds

URL请求参数

参数	类型	描述	其它
deviceId	integer	设备ID（必填）	Required
apiTag	string	传感标识名（参数必须但值可为空）	Required

Http Body 内容

用户自定义数据：integer/float/json/string/二进制等类型值，例如
开关类：开 = 1，关 = 0，暂停 = 2
家居类：调光灯亮度=0~254，RGB灯色度=2~239，窗帘、卷闸门、幕布打开百分比=3%~100%，红外指令=1(on)2(off)

提示：可以通过开发者中心-》项目管理-》API调试工具调度命令接口，该值点击【自定义参数值】来输入。。

响应参数

参数	类型	描述
ResultObj	string	命令ID，GUID格式的字符串，平台范围内唯一
Status	ResultStatus	返回状态
StatusCode	integer	返回的状态码
Msg	string	返回的消息
ErrorObj	Object

几个示例

请求示例一

【POST】 http://api.nlecloud.com/Cmds?deviceId=121531&apiTag=nl_fan HTTP/1.1
AccessToken: **************************

{ this is a command }

返回示例1：成功创建命令
{
    "ResultObj": 24568575-7167-4DA7-9515-965416EF8745,
    "Status": 0,
    "StatusCode": 0,
    "Msg": "",
    "ErrorObj": null
}

返回示例2：设备不在线
{
    "ResultObj": null,
    "Status": 1,
    "StatusCode": 1,
    "Msg": "可能设备ID【121531】还未上线！",
    "ErrorObj": null
}