对接中台 · 模块使用指南

一分钟理清两个板块

对接中台只有两个板块，分工一句话：应用配置管理管通行证和数据授权（底座），应用广场管师生看到的应用入口（门面）。第三方应用要免密登录，先有底座、再上门面。

登录数字基座平台，门户页点「对接中台」。校级管理员直接管理本校；教育局端不涉及此模块。

从应用市场挑模板、填第三方给贵校的编码、设可见范围、手动开启，师生端立即出现入口。

开通对接平台或发放开放凭据、逐项勾选数据授权，接口文档自动生成、可直接发给对方。

学校开通的第三方应用以卡片墙呈现，开没开启一目了然。每张卡直接操作：开启 / 关闭、编辑、删除。

点「添加应用」打开应用市场：平台已适配的应用标注「需填几项」，挑一个、填编码、设可见、开启，四步上线。

市场里选模板；没有的选「自定义链接」，填名称和网址直接添加。

表单顶部有提示：对接方式、免密登录、显示位置已由平台配好，你只需填第三方给贵校的编码等一两项。涉及密码的参数以密文保存。

第一级选范围（全体 / 仅管理员 / 班主任 / 年级长 / 指定人员）；选「指定人员」再选对象——教师可按角色和个人多选（命中任一即可见），学生按年级多选。管理员始终可见。

新添加的应用默认未开启；确认配置无误后开启，师生端应用广场立即出现入口，点开自动免密登录。

已对接的第三方平台在这里集中管理：每行一个平台，状态开关即时启停，操作列四个按钮——配置应用权限、接口文档、编辑、删除。

我方已适配的第三方平台，选模板、填第三方给学校的参数即可，数据同步与账号匹配平台已配好。

第三方要调我们的数据：系统自动生成一对「编码 + 密钥」。密钥只展示一次，复制发给对方后就再也看不到明文；丢失只能重置。

模板没覆盖的对接，由技术运营手动填写完整参数；敏感项以掩码回显，保持不动即不修改。

第三方能调什么数据，逐项勾选说了算；勾选结果保存后，给对方开发人员看的接口文档同步更新——文档永远和授权一致。

上手过程中最常被问到的八个问题。

添加了应用，师生为什么看不到？

检查两处：一是应用是否已「开启」（新添加默认未开启，卡片是变淡的）；二是可见范围是否覆盖到目标人群——设了「指定人员」时，只有命中所选角色 / 人员 / 年级的师生能看到。

应用市场里没有我们要接的应用怎么办？

用「自定义链接」：填应用名称和网址直接添加。对方支持免密登录时选「携带登录票据」，否则选「直接打开」。也可以联系平台方把该应用做成模板。

密钥忘了 / 怀疑泄露了怎么办？

密钥只在创建时展示一次，之后无法查看明文。点「重置密钥」即可：新密钥同样一次性展示，旧密钥立即作废，第三方需要更换后才能继续调用。

怎么临时切断某个第三方的对接？

在应用配置管理把该平台的状态开关拨到「停用」——该对接的全部调用立即被拒绝，配置保留，随时可恢复。应用广场同理：关闭应用即对师生隐藏。

第三方说调接口报「无权限」，怎么排查？

打开该平台的「配置应用权限」，确认对应接口已勾选并保存；再确认平台状态是「启用」。授权保存后接口文档同步更新，可让对方对照文档核对调用的接口是否在授权清单内。

接口文档能直接发给第三方开发人员吗？

能。文档页右上角「复制链接」即可分享，对方打开需要登录本系统且对该平台有权限；也可以「打印 / 导出」成文件发送。文档内容随授权变化自动更新，不用人工维护。

删除对接平台有什么影响？

删除前会有明确警告：引用该对接编码的应用将无法完成免密登录。建议先在应用广场处理关联应用，再删除对接平台；如只是暂停合作，用「停用」而不是删除。

教育局账号为什么看不到对接中台？

对接第三方应用被定位为校级事务：校级管理员管理本校，平台运营方可代学校操作，教育局端不开放此模块。