数字空间接口概述

1.简介

微瓴DataSpace即微瓴数字空间，提供关于数据的计算、存储、管理与分发，包括静态地理数据的格式规范、编码体系、数据管理、模型构建；动态物联设备数据的系统对接、协议标准、数据上报、解析转换、分析清洗、逻辑流转、规则联动等服务。

应用开发商、设备开发者可通过数字空间提供的可视化配置，实现简单易用的配置管理和规则联动，以微服务架构来设计分布式调用逻辑，基于简单、实用、灵活的理念，每一个服务拥有各自的某一端到端业务场景（功能）与数据（数据库），服务之间互相不共享，避免产生依赖或继承抽象的接口、服务、模块。

2.特性与定义

接入微瓴：见微瓴接入说明：

https://api.weiling.qq.com/doc/Guide.html#_1-%E4%BA%A7%E5%93%81%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97

你可以上报设备数据（状态、位置、）

通过微瓴可以获得的数据：

A. 静态数据（低频变化）

基础地理

地图

路线

地点

设备地理

B. 动态数据（高频变化）

物联设备

水电煤气表

能源、空调、冷机、给排水、消防、报警、广播、变配电、电梯、门禁等

移动对象（人、车、Robot位置）

上报位置

获取实时定位

C. 数据挖掘服务

  统计与分析

  数据学习

3.名词解释

wId

为唯一ID，可理解为身份证，全平台通用字段，以参数形式使用。

wId可代表

静态的（建筑、楼层、房间、地点），

动态的（物联设备、移动对象人、车、机器人）

某种组合服务等。

POIID

地理层级ID，可表达地理嵌套关系，具体可参考下图地理层级关系图。

父子包含关系通过POIID规则继承示意图

POICODE

分类编码，区分不同种类。设备导入平台后可在设备详情查看

Projectid

项目id号。

与物联设备控制有关

DIN

物联设备唯一标识，可以是物联网关

Subid

子设备id，同一个物联网关可级联多个子设备，通过子设备id实现独立控制。

与权限验证及登录有关

token

动态密钥，有效时间20分钟，需重新登录。所有访问均需要带着token来获取。

appid

应用系统的 id，由平台分配，在开放平台注册申请。

https://open.welink.qq.com/#/dev-resource/guide/app-access

appsecret

同上。

app_ticket

用于登录API的应用票据，app_ticket有时间期限，请注意及时更新票据

Sig

加密的密文，用于登录API使用，生成方式见生成签名样例

生成规则，参考以下链接中的“签名机制”。

https://api.weiling.qq.com/doc/Application_of_API.html#_4-%E7%AD%BE%E5%90%8D%E6%9C%BA%E5%88%B6

message_type

message_type	说明
1000100	文本消息广播至相关联的应用系统
1000101	Json消息广播至相关联的应用系统
1000200	发送文本消息至其他应用系统
1000201	发送Json消息至其他应用系统
1000300	表示告警类消息
1000302	表示消警类消息
1000400	表示通知类消息
1000500	推送普通消息给微瓴平台作为数据存储，不推送给应用

注：注：对象模型上报，不论是告警、通知、消警都统一使用1000500

设备影子

设备影子是服务器端为设备缓存的一份状态和配置数据，代表着物理设备的一个数字化映射。

消息订阅

websocket