Appearance
北向接入
功能说明
平台采集的数据往往不是终点，上层的 MES/ERP/大数据平台还要用。北向接入解决“数据怎么给出去”的问题：要么开放 API 让第三方来取（开放平台），要么平台主动把数据推出去（数据转发）。
举例： 工厂的 MES 系统要实时拿到产线设备数据，可通过开放平台申请一对凭证换 Token 调 API 查询；或配置数据转发把数据按 MQTT 主题推给 MES 订阅。
平台提供两种方式将设备数据开放给第三方系统：开放平台（对外提供 API）和数据转发（主动把数据推送到外部）。
开放平台
菜单：北向接入 → 开放平台
为第三方系统颁发接入凭证，第三方凭凭证通过 OAuth2 换取 Token 后调用平台 API（查询设备数据、下发控制指令等）。这是一个列表式管理页面，每条记录对应一个接入应用。
配置项
| 字段 | 说明 | 是否必填 |
|---|---|---|
| 应用名称 | 接入应用的名称，便于识别 | 必填 |
| 关联账号 | 绑定平台的一个管理员账号，接口调用继承该账号的数据权限 | 必填 |
| 授权主机 | 允许调用接口的主机地址白名单，多个地址用换行分隔；留空不限制 | 选填 |
| 备注 | 应用用途说明 | 选填 |
凭证说明
保存后平台自动生成一对凭证，展示在列表中，均支持一键复制：
| 凭证 | 作用 |
|---|---|
| 应用标识（clientId） | 应用的唯一标识 |
| 应用密钥（clientSecret） | 换取 Token 的密钥，需妥善保管 |
操作步骤
- 进入 北向接入 → 开放平台，点击"新增"
- 填写应用名称、选择关联账号，按需填写授权主机、备注
- 保存后在列表中复制应用标识和应用密钥
- 第三方用应用标识/应用密钥完成 OAuth2 授权换取 Token，再用 Token 调用平台 API
- 列表行支持启用/停用、修改、删除，停用后该应用凭证立即失效
数据转发
菜单：北向接入 → 数据转发
将平台采集到的数据通过 MQTT 发布主动推送到外部 MQTT Broker，供第三方订阅消费。该页面是预置的配置项（以标签页形式呈现），填写连接参数保存后手动连接即可，不需要"新增"。
配置项
| 字段 | 说明 | 是否必填 |
|---|---|---|
| 主机 | 外部 MQTT Broker 的地址 | 必填 |
| 端口 | Broker 端口（0~65535） | 必填 |
| 用户名 | Broker 认证用户名 | 选填 |
| 密码 | Broker 认证密码 | 选填 |
| clientId | 连接 Broker 的客户端标识 | 必填 |
| 消息等级 | MQTT QoS 等级（0/1/2，默认 0） | 必填 |
| 发布主题 | 数据发布到的目标主题 | 必填 |
| 状态 | 启用 / 禁用 | 必填 |
操作步骤
- 进入 北向接入 → 数据转发
- 在标签页中填写主机、端口、clientId、发布主题等连接参数
- 点击"保存"（必须先保存，才能进行连接/断开操作）
- 点击"连接"建立与外部 Broker 的连接，平台数据即按配置发布出去；点击"断开"停止转发