对接中台 · 业务全景可视化

第三方应用接入学校的标准动作:上架有货架、凭据有账本、授权有边界、文档自动出、可见能精调。

2大功能板块
6步上架全流程
3级可见范围精调
1份自动生成的对接文档

两大板块,一进一出

「应用广场」管进——第三方应用进学校,师生一键打开免重复登录;「应用配置管理」管出——学校数据按授权范围开放给第三方。两者靠同一份对接凭据关联。

应用广场 · 师生看得见的货架
  • 从市场挑:平台已适配的应用,填第三方给贵校的编码即可开通
  • 自定义补:市场没有的应用,填名称和网址直接添加
  • 可见精调:全体 / 仅管理员 / 班主任 / 年级长 / 指定到人
  • 两步上线:先配置、后开启,确认无误才对师生可见
应用配置管理 · 对接的账本
  • 发通行证:给第三方发对接凭据,密钥只展示一次
  • 定授权:逐项勾选对方能调取的数据,给多少勾多少
  • 文档自动出:接口说明书自动生成,授权一变文档跟着变
  • 随时切断:停用开关、重置密钥,主动权始终在学校
对接中台是校级事务:校级管理员管理本校应用与对接,平台运营方可代学校操作;教育局端不涉及此模块。

应用广场 · 六步上架一个应用

对接方式、免密登录、显示位置都由平台配好,管理员只填第三方给贵校的编码——把技术复杂度藏起来,上架像网购一样简单。

上架流程演练

以「希沃班牌」为例,点按钮走一遍应用从挑选到上线的全过程。

逛应用市场挑选希沃班牌
填学校编码第三方提供
设可见范围谁能看到入口
手动开启二次确认上线
师生使用点开免密登录
当前状态:未添加。点按钮开始上架。

模板应用

推荐

平台已完成对接适配,填一两项参数即可开通,免密登录开箱即用。

自定义链接

兜底

市场没有的应用填名称和网址直接加;对方支持免密登录时可选「携带登录票据」。

两步上线

防误操作

新添加的应用默认「未开启」,回列表手动开启才对师生可见——配置、上架两步确认。

可见范围 · 三级精调给谁看

不是所有应用都该全员可见:共享账号的应用只给管理员,班级管理工具只给班主任,毕业班专用只开初三。点下面的选项试试组合效果。

可见范围模拟器

第一级选范围;选「指定人员」时出现第二级对象和第三级精调。

应用配置管理 · 通行证怎么发

三种对接方式覆盖全部场景;密钥安全设计贯穿始终——只展示一次、可随时重置、敏感项不回显。

从模板开通

应用进学校

我方已适配的第三方平台:数据同步、账号匹配平台配好,学校只填第三方给的编码。

开放应用

数据出学校

第三方要调取我们的数据:系统自动生成一对「编码 + 密钥」发给对方,无需填写。

自定义平台

高级

模板没覆盖的对接,由技术运营手动填写完整参数。

密钥生命周期演示

点按钮体验密钥从生成到重置的全过程——为什么说"只展示一次"。

尚未创建开放应用。
密钥展示区

数据授权 · 给多少勾多少

第三方只能调用被勾选的数据接口,一项没勾一项调不了。授权保存后,给对方开发人员看的接口文档同步更新——文档永远和授权一致。

授权勾选演示

点分组名整组勾选 / 取消,点单项精细调整。右下角实时统计。

两条对接通道

数据调取:第三方服务器凭凭据加签,按授权范围调取数据。
免密登录:师生点开应用时走标准授权流程,第三方拿到的只是当前用户的身份确认,不是数据库。

接口文档自动生成

每个对接平台一份专属文档:只列已授权的接口,附调用方式和参数说明。可新窗口打开、复制链接给对方(对方也需登录且有权限)、可打印导出。

数据从哪来、到哪去

一进一出两条线,全程可管可控:应用随时可下架,授权随时可增减,密钥随时可作废。

底座:应用配置管理 —— 对接凭据(编码 + 密钥)与数据授权的账本 密钥一次性展示 · 可重置作废 · 授权逐项勾选 · 文档自动同步 进 · 第三方应用接入学校 应用广场挑模板 → 填学校编码 → 设可见范围 默认未开启 → 手动开启上线 师生端出现入口 → 点开免密登录直达 随时可关闭 / 编辑 / 删除 出 · 学校数据开放给第三方 发放开放凭据(一次性展示)→ 勾选授权接口 第三方加签调取:名单 / 班级 / 课表 / 请假 / 考试 接口文档自动同步授权范围 停用或重置密钥即刻切断 师生在校内应用广场使用 按可见范围呈现:全体 / 管理员 / 班主任 / 年级长 指定人员可细到角色、个人;学生按年级 第三方系统按授权使用数据 只能调用被勾选的接口,一项没勾一项调不了 每次调用都要加签验证身份 主动权始终在学校 应用可下架 · 授权可增减 · 密钥可作废 · 停用即断

状态速查表

系统里出现的每一种状态标签,含义都在这里。

场景状态含义
应用未开启已开启新添加默认未开启;开启后师生端立即可见
可见范围全体仅管理员班主任年级长指定人员指定人员可细化到角色、个人、年级;管理员始终可见
自定义应用打开方式直接打开携带登录票据对方支持免密登录时选携带
对接平台启用停用停用即拒绝该对接的全部调用
对接密钥一次性展示已收起已重置明文只出现一次;重置后旧密钥立即作废
数据授权已勾选未勾选勾了才能调;接口文档只显示已勾选项
敏感参数密文保存编辑时留空=不修改,不回显原文