检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
application/x-www-form-urlencoded 对于其他接口，还需要在请求消息头中添加app_key和Authorization，以注册设备（验证码方式）接口为例，添加消息头后的请求如下所示，“******”需要根据实际值填写。 POST https://iot-api.cn-north-4
body 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId 必选 String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
ation Object Body 设备的自定义字段列表。 表1 deviceMessageChangedNotification 名称 必选/可选 类型 说明 device_id 必选 String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 message
物联网平台提供设备配置更新功能，即用户可通过控制台对单个设备或批量设备的设备属性值进行修改，满足用户频繁、快捷、方便的管理设备的诉求。 设备影子 设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以
/workdir", null); 绑定和登录 设备或网关第一次接入物联网平台时需要进行绑定操作，从而将设备或网关与平台进行关联。开发者通过传入设备验证码以及设备信息，将设备或网关绑定到物联网平台。 修改绑定参数。 绑定时使用的设备固有信息（如设备型号等）是从“AgentLiteBind
body 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId 必选 String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
配获得。 status 必选 String 设备状态。 ONLINE：设备在线 OFFLINE：设备离线 ABNORMAL：设备异常 timestamp 必选 String 设备状态变化时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。
消息的序列号，唯一标识一条消息。 name 可选 String 消息名称。 device_id 必选 String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 status 可选 String 设备消息状态，包含：PENDING,DELIVERED,TIMEOUT,FAILED。 timestamp
必选 String body 设备的类型。 manufacturerName 必选 String body 设备模型的厂商名称。 manufacturerId 必选 String body 设备模型的厂商ID。 model 必选 String body 设备型号。 protocolType
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQ
必选 String body 设备的类型。 manufacturerName 必选 String body 设备模型的厂商名称。 manufacturerId 必选 String body 设备模型的厂商ID。 model 必选 String body 设备型号。 protocolType
必选 String body 设备的类型。 manufacturerName 必选 String body 设备模型的厂商名称。 manufacturerId 必选 String body 设备模型的厂商ID。 model 必选 String body 设备型号。 protocolType
设备登出 接口功能 断开与物联网平台的连接。 接口描述 1 HW_INT IOTA_Logout(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果，返回0只是说明接口调用成功。 示例 1 2 // 开发者调用设备登出接口： IOTA_Logout(); 父主题：
body 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 gatewayId 必选 String body 网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
String path 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 appId 可选 String query 设备所属的应用ID，当删除授权应用下的设备时才需要填写。 cascade 可选 Boolean query 仅当设备下连接了非直连设备时生效。默认值为true。
删除设备 接口功能 当有新设备需要从网关移除时，通过调用设备删除接口将非直连设备从物联网平台删除。 接口描述 1 public static boolean rmvDevice(int cookie, String deviceId); 接口所属类 HubService 参数说明
设备命令下发 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设
删除设备通知 典型场景 第三方应用在物联网平台订阅了删除设备通知后（订阅的通知类型为deviceDeleted），当设备在物联网平台中被删除后，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了删除设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
