开发者中心

应用开发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
}