检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
开放API接口，向各种协议的设备提供API对接。为了提供更加丰富的设备管理能力，物联网平台需要理解接入设备具备的能力以及设备上报数据的格式，因此，您需要在控制台上完成产品模型和插件的开发。 产品模型是用来描述设备能力的文件，通过JSON的格式定义了设备的基本属性、上报数据和下发命
实现平滑升级。 NB-IoT是IoT领域一个新兴的技术，支持低功耗设备在广域网的蜂窝数据连接，也被叫作低功耗广域网（LPWAN）。NB-IoT支持待机时间长、对网络连接要求较高设备的高效连接。据说NB-IoT设备电池寿命可以提高至至少10年，同时还能提供非常全面的室内蜂窝数据连接覆盖。
String 鉴权类型。当前支持密钥认证接入(SECRET)。使用密钥认证接入方式(SECRET)填写secret字段，不填写auth_type默认为密钥认证接入方式(SECRET)。 secret String 网桥密钥，认证类型使用密钥认证接入(SECRET)可填写该字段。 请求示例 POST
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
设备时间同步响应 功能描述 平台向设备发送时间同步响应，携带设备发送时间device_send_time。当平台收到时间server_recv_time 后，向设备发送时间server_send_time 。 例如，设备收到的设备侧时间为device_recv_time ，则设备计算自己的准确时间为：
限制offset最大值是出于API性能考虑，您可以搭配marker使用该参数实现翻页，例如每页50条记录，1-11页内都可以直接使用offset跳转到指定页，但到11页后，由于offset限制为500，您需要使用第11页返回的marker作为下次查询的marker，以实现翻页到12-22页。
样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。
静态策略 概述 静态策略，即设备关键字模糊匹配的发放策略。每条静态策略实例指：匹配上该策略实例的设备，将会被发放到该条策略实例关联的设备接入实例的对应资源空间（即应用）下。 设备匹配静态策略实例的机制为： 设备的发放策略为“静态策略”，设备的关键字来源字符串包含某一静态策略实例的
样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。
删除产品 功能介绍 应用服务器可调用此接口删除已导入物联网平台的指定产品模型。此接口仅删除了产品，未删除关联的插件，在产品下存在设备时，该产品不允许删除。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/products/{product_id}
List<DeviceProperty> Body 参数解释: 设备数据列表。 取值范围: 长度不超过50。 表1 DeviceProperty 名称 必选 类型 说明 device_id 是 String 参数解释: 子设备的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 取值范围:
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
String 设备类型。 protocol_type String 设备使用的协议类型。取值范围：MQTT，CoAP，HTTP，HTTPS，Modbus，ONVIF， OPC-UA，OPC-DA，TCP，UDP，Other。 data_format String 设备上报数据的格式，取值范围：json，binary。
义，由英文字母和数字组成。 设备名称 即device_name，可自定义。 设备认证类型 选择“密钥”。 密钥 设备密钥，可自定义，不填写物联网平台会自动生成。 图10 所有设备-注册设备 成功注册设备后，平台会自动生成设备ID和密钥，请妥善保管好设备ID（deviceId）和密
样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。
设备接收引导信息 接口功能 设备接收发放服务下发的引导信息。 Topic 表1 下发Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/down 消息发送方 设备发放平台 消息接收方 设备 参数说明 表2 下发参数说明 参数 必选/可选
发放区域 发放到指定区域后，设备将接入对应区域的设备接入服务。 所选区域未开通设备接入服务时，如果确定添加实例，系统将自动为您开通设备接入服务。不同区域设备接入服务价格不同，收费详情请参考价格说明。 发放应用 选择对应设备接入服务区域已创建的应用。在物联网平台中，设备由应用统一管理。 如
限制offset最大值是出于API性能考虑，您可以搭配marker使用该参数实现翻页，例如每页50条记录，1-11页内都可以直接使用offset跳转到指定页，但到11页后，由于offset限制为500，您需要使用第11页返回的marker作为下次查询的marker，以实现翻页到12-22页。
可选 设备软件升级能力。 - supportUpgrade 可选 true：设备支持软件升级。 false：设备不支持软件升级。 - upgradeProtocolType 可选 升级使用的协议类型，此处不同于设备的protocolType，例如CoAP设备软件升级协议使用PCP。
以NB-IoT场景为例，编解码插件将设备上报的二进制数据解码为JSON格式供应用服务器“阅读”，将应用服务器下行的JSON格式命令编码为二进制格式数据供终端设备（UE）“理解执行”。NB-IoT设备和物联网平台之间采用CoAP协议通讯，CoAP消息的payload为应用层数据，应用层数据的格式由设备自行定义
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
