OneNET Studio 简介产品介绍

功能介绍资源模型名词解释

快速入门

账户与登录实名认证

设备接入与管理

设备接入流程创建产品开发产品物模型

什么是物模型？物模型管理物模型通信协议

OneJSON

协议简介设备属性/事件设备服务设备期望属性值管理拓扑关系子设备上下线子设备数据交互 LwM2M拓展

数据解析

什么是数据解析？脚本开发 MQTT设备开发 LwM2M设备开发最佳实践

创建设备转移设备文件管理远程配置标准协议接入

接入概述接入安全认证设备接入SDK MQTT协议接入

MQTT设备连接通信主题使用限制最佳实践

CoAP协议接入

CoAP设备连接使用限制

LwM2M协议接入

LwM2M协议规范 LwM2M-Studio概览 LwM2M设备创建 LwM2M设备开发

HTTP协议接入

HTTP接入使用说明 HTTP接入接口列表

直连设备API

设备属性上报设备事件上报批量数据上报历史数据上报

代理设备API

设备属性上报设备事件上报批量数据上报历史数据上报子设备上线子设备下线添加子设备删除子设备获取拓扑关系

泛协议接入

服务概述代理直连设备代理网关设备 SDK开发指南最佳实践-云云对接最佳实践-代理直接设备最佳实践-代理网关设备相关限制 SDK历史版本文档

1.0.3 Version

SDK开发指南最佳实践-代理直接设备

物模版库生态接入认证

应用开发

应用开发流程新建项目添加设备设备分组场景联动应用数据流转

规则引擎

服务概述消息源格式 SQL说明消息目的地

消息队列MQ HTTP推送

HTTP数据推送消息队列MQ

应用API

使用说明安全鉴权错误码 SDK下载设备管理类

设备创建设备批量创建设备编辑设备删除设备详情设备转移物模型系统功能点物模型查询设备工业标识注册

应用开发类

项目概况项目集成产品列表项目集成设备列表项目添加设备项目移除设备分组创建分组删除分组编辑分组详情分组列表分组设备添加分组设备移除设备详情设备状态查询设备状态记录查询设备属性设置设备属性获取设备属性期望设置设备属性期望查询设备属性期望删除设备操作日志查询设备最新数据查询设备属性记录查询设备事件记录查询设备服务调用设备服务执行记录查询设备文件上传设备文件下载设备文件删除账户文件列表查询账户文件存储空间查询账户设备文件数量查询场景联动规则创建场景联动规则编辑场景联动规则详情场景联动规则列表场景联动触发日志

LwM2M-IPSO类

即时命令API

设备资源列表获取资源发现资源订阅读设备资源写设备资源命令下发

缓存命令API

读设备资源写设备资源命令下发

DTLS相关API

查看设备bs_psk 更新bs_psk 新增acc_psk 编辑acc_psk 查看设备acc_psk

应用长连接

服务概述最佳实践

规则引擎（新）

服务概述消息源格式 SQL说明

运维监控

设备调试 API调试日志服务告警中心远程升级设备防御

数据可视化边缘计算人工智能AI 位置定位

服务简介产品定价基站定位开发指南基站位置查询API WiFi定位开发指南 WiFi位置查询API

语音通话

服务简介产品定价语音通知模板规范 API接口

API使用说明错误码语音通知语音通知状态呼叫通知点击拨号点击拨号状态呼叫通知

工业互联网标识

服务简介服务开通前缀管理数据模板标识管理

权限管理

服务简介主账户操作协作账户操作

服务协议

公测服务协议位置定位服务协议语音通话服务协议工业互联网标识服务协议

HTTP 接入简介

1. HTTP接入概述

2. HTTP 接入API格式

3. HTTP接入地址

4. HTTP接入数据规范

5. HTTP接入鉴权设计

6. HTTP接入返回码设计

1. HTTP接入概述

支持设备使用HTTPS/HTTP2协议上报数据，分为直连设备和代理子设备，直连设备不显示在线状态，网关子设备可显示设备的在线状态。

2. HTTP 接入API格式

POST https://${Address}/${url}?${url参数}

Header参数:token，Content-Type

Body:OneJson

参数类型	说明
Method	请求方法，只支持POST方法,支持HTTPS,HTTP2协议
Address	具体请求ip或域名地址
Url	请求路径，如：/device/thing/property/post
Header参数	1.token:鉴权参数的token值 2.Content-Type:application/json
URL参数	1.topic，请求参数topic，见2.1中的topic。 2.protocol 协议类型，(MQTT,COAP,OTHER)
Body	请求内容，内容格式同OneJson

数据上报OneJson格式参照： https://open.iot.10086.cn/doc/iot_platform/book/device-connect&manager/thing-model/protocol/OneJSON/property&event.html

子设备数据上下线OneJson格式参照： https://open.iot.10086.cn/doc/iot_platform/book/device-connect&manager/thing-model/protocol/OneJSON/subdevice-loginout.html?h=%E5%AD%90%E8%AE%BE%E5%A4%87%E4%B8%8A%E7%BA%BF#2-%E5%AD%90%E8%AE%BE%E5%A4%87%E4%B8%8B%E7%BA%BF

3. HTTP接入地址

标识符	地址
Address	https://open.iot.10086.cn/studio/http

4. HTTP接入数据规范

根据Studio物模型规范，支持上报的数据如下表：

功能类型	topic	直连设备是否支持	网关子设备是否支持
设备属性上报	$sys/{pid}/{device-name}/thing/property/post	是	是（采用设备批量数据上报）
设备事件上报	$sys/{pid}/{device-name}/thing/event/post	是	是（采用设备批量数据上报）
设备批量数据上报	$sys/{pid}/{device-name}/thing/pack/post	是	是
设备历史数据上报	$sys/{pid}/{device-name}/thing/history/post	是	是
子设备上线	$sys/{pid}/{device-name}/thing/sub/login	否	是
子设备下线	$sys/{pid}/{device-name}/thing/sub/logout	否	是
添加子设备	$sys/{pid}/{device-name}/thing/sub/topo/add	否	是
删除子设备	$sys/{pid}/{device-name}/thing/sub/topo/delete	否	是
获取拓扑关系	$sys/{pid}/{device-name}/thing/sub/topo/get	否	是

5. HTTP接入鉴权设计

根据topic中的$sys/{pid}/{device-name}/*中的pid和device-name参照studio设备安全鉴权生成token作为鉴权参数。具体参照： https://open.iot.10086.cn/doc/iot_platform/book/device-connect&manager/device-auth.html

6. HTTP接入返回码设计

序号	错误码	描述
0	succ	成功
1	internalServerError	内部错误
2	authPermissionDeny	鉴权失败
4	parameterRequired	缺少请求参数
6	invalidParameter	不合法的请求参数
17	setPropertyFailed	设备属性设置失败
21	callTmServiceFailed	物模型服务调用失败
32	subDeviceLoginFailed	子设备登录失败
33	subDeviceLogoutFailed	子设备登出失败
34	addTopoFailed	添加子设备失败
35	deleteTopoFailed	删除子设备失败
36	getTopoFailed	查询拓扑关系失败
37	reachRateLimit	达到请求限制

这篇文档是否帮助您解决了问题?

个搜索结果，搜索内容 “”

0 个搜索结果，搜索内容 “”