开放协议接入-华为云

设备接入 IOTDA-HTTPS协议接入:设备鉴权接口说明

设备鉴权接口说明设备鉴权接口鉴权通过后才能建立设备与平台间的业务处理连接。鉴权成功后平台返回access_token，调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token。如果access_token未超期重复获取access_token，原access_token在未超期前保留30s，30s之后失效。请求方法 POST URI /v5/device-auth 传输协议 HTTPS 名称必选类型位置说明 device_id 是 String Body 参数说明: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "_" + "node_id"拼接而成。取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。取值范围: 长度1-128 sign_type 是 Integer Body 参数说明: 密码校验方式: 0 代表HMA CS HA256校验时间戳时不会校验消息时间戳与平台时间是否一致，仅判断密码是否正确; 1 代表HMACSHA256校验时间戳时会先校验消息时间戳与平台时间是否一致，再判断密码是否正确。取值范围: 大小0~1 timestamp 是 String Body 参数说明: 时间戳：为设备连接平台时的UTC时间，格式为YYYYMMDDHH，如UTC 时间2018/7/24 17:56:20 则应表示为2018072417。取值范围: 固定长度10 password 是 String Body 参数说明: password的值为使用“HMACSHA256”算法对secret进行签名后的密钥（以时间戳为key，对平台返回的secret进行签名后的值，参考密钥生成工具）。secret为注册设备时平台返回的secret。取值范围: 固定长度64 名称类型说明 access_token String 参数说明: 设备token，用于设备鉴权。取值范围: 长度32-256 expires_in Integer 参数说明: 鉴权信息的剩余有效时间, 单位：秒。请求示例如下： POST https://{endpoint}/v5/device-auth Content-Type: application/json { "device_id" : "********", "sign_type" : 0, "timestamp" : "2019120219", "password" : "********" } 响应示例如下： Status Code: 200 OK Content-Type: application/json { "access_token" : "********", "expires_in" : 86399 } HTTP状态码 HTTP状态码描述错误码错误码描述错误码中文描述 200 OK - - - 400 Bad Request IOTDA.000006 Invalid input data. 请求参数不合法 401 Unauthorized IOTDA.000002 Authentication failed. 鉴权失败 403 Forbidden IOTDA.021101 Request reached the maximum rate limit. 请求已经达到限制速率 IOTDA.021102 The request rate has reached the upper limit of the tenant, limit %s. 请求已经达到租户的限制速率

设备接入 IOTDA 开放协议接入

设备接入 IOTDA-HTTPS协议接入:设备消息上报接口说明

设备消息上报接口说明用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 名称必选类型位置说明 access_token 是 String Header 参数说明: 调用设备鉴权信息返回的access_token。取值范围: 长度1-256 device_id 是 String Path 参数说明: 参数说明：设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id" + "_" + "node_id"拼接而成。取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。取值范围: 长度1-128 该接口支持设备将自定义数据通过请求中的body体上报给平台，平台收到该请求后会将body内容转发给应用服务器或华为云其他云服务上进行存储和处理。平台对body中的内容无具体格式限制，小于1MB的数据可以通过该接口携带。请求示例如下： POST https://{endpoint}/v5/devices/{device_id}/sys/messages/up Content-Type: application/json access_token: ******** { "name" : "name", "id" : "id", "content" : "messageUp" } 响应示例如下： Status Code: 200 ok HTTP状态码 HTTP状态码描述错误码错误码描述错误码中文描述 200 OK - - - 400 Bad Request IOTDA.000006 Invalid input data. 请求参数不合法 401 Unauthorized IOTDA.000002 Authentication failed. 鉴权失败 403 Forbidden IOTDA.000004 Invalid access token. 非法token IOTDA.021101 Request reached the maximum rate limit. 请求已经达到限制速率 IOTDA.021102 The request rate has reached the upper limit of the tenant, limit %s. 请求已经达到租户的限制速率

设备接入 IOTDA 开放协议接入

设备接入 IOTDA-HTTPS协议接入:使用限制

使用限制描述限制支持的HTTP协议版本支持 Hypertext Transfer Protocol — HTTP/1.0 协议支持 Hypertext Transfer Protocol — HTTP/1.1 协议支持HTTPS协议物联网平台仅支持HTTPS协议，证书下载请参考证书资源。支持的TLS版本 TLS 1.2 支持的body体最大长度 1MB 接口规格说明请参考产品规格说明。网关上报子设备属性时一次最大可上报子设备数 50

设备接入 IOTDA 开放协议接入

设备接入 IOTDA-HTTPS协议接入:HTTPS设备与物联网平台通信

HTTPS设备与物联网平台通信设备使用HTTPS协议接入平台时，平台和设备通过HTTPS接口调用通信。通过这些接口，平台和设备可以实现设备鉴权、消息上报及属性上报。消息类型说明设备鉴权用于设备获取鉴权信息access_token。设备属性上报用于设备按产品模型中定义的格式将属性数据上报给平台。设备消息上报用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。网关批量属性上报用于网关设备将多个子设备的属性数据一次性上报给平台。

设备接入 IOTDA 开放协议接入

设备接入 IOTDA-HTTPS协议接入:业务流程

业务流程设备接入前，需创建产品（可通过控制台创建或者使用应用侧API创建产品）。产品创建完毕后，需注册设备（可通过控制台注册单个设备或者使用应用侧API注册设备创建）。设备注册完毕后，通过设备鉴权接口获取设备的access_token。图1 获取设备access_token 获取到access_token之后，可以使用消息/属性上报等功能。其中access_token放于消息头中，下面示例为上报属性：图2 上报属性图3 上报属性

设备接入 IOTDA 开放协议接入

设备接入 IOTDA-HTTPS协议接入:HTTP接口介绍

HTTP接口介绍物联网平台的接口如下表所示：接口分类 API 接口说明设备鉴权相关接口设备鉴权接口说明 /v5/device-auth 设备鉴权接口，鉴权通过后才能建立设备与平台间的业务处理连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token。如果access_token未超期重复获取access_token，原access_token在未超期前保留30s，30s之后失效。设备消息相关接口设备消息上报接口说明 /v5/devices/{device_id}/sys/messages/up 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。设备属性相关接口设备属性上报接口说明 /v5/devices/{device_id}/sys/properties/report 用于设备按产品模型中定义的格式将属性数据上报给平台。网关上报子设备属性接口说明 /v5/devices/{device_id}/sys/gateway/sub-devices/properties/report 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报最多50个子设备的属性数据。

设备接入 IOTDA 开放协议接入

设备接入 IOTDA-LwM2M/CoAP协议接入:概述

概述 LwM2M（Lightweight M2M，轻量级M2M），由开发移动联盟（OMA）提出，是一种轻量级的、标准通用的物联网设备管理协议，可用于快速部署客户端/服务器模式的物联网业务。LwM2M为物联网设备的管理和应用建立了一套标准，它提供了轻便小巧的安全通信接口及高效的数据模型，以实现M2M设备管理和服务支持。物联网平台支持加密与非加密两种接入设备接入方式，其中加密业务数据交互端口为5684端口，采用DTLS+CoAP协议通道接入，非加密端口为5683，接入协议为CoAP。物联网平台从安全角度考虑，强烈建议采用安全接入方式。 LwM2M的语法和接口细节，请以此标准规范为准。物联网平台支持协议规定的plain text, opaque, Core Link ,TLV , JSON编码格式。在多字段操作时（比如写多个资源），默认用TLV格式。

设备接入 IOTDA 开放协议接入

云服务器内容精选

开放协议接入

7*24

备案

专业服务

退订

建议反馈

售前咨询热线