# 自建应用接入规范

自建应用是由UNI超级管理员自行创建的只在学校/企业内使用的应用,并且无需通过腾讯微卡审核流程可直接上线。

# 1、如何创建自建应用

登录腾讯微卡平台并在选择相应的学校/企业进入后台管理界面,选择应用,点击左边列表中的自建应用管理,再点击页面展示中的创建应用

资料页面图

# 2、应用配置的提交以及开启

2.1 进入添加自建应用,按照如图所示,填写应用名称以及应用简介,上传LOGO图片,完成后点击提交。

上架流程图

2.2 提交后,应用已经创建,但还需填写相关配置信息,如填写业务域名(非必填),选择应用形态,选择后台管理方式,填写应用地址(必填)。当必填的资料填完之后才能开启应用。后面模块接口文档中使用的APPKEY以及APPSERCRET皆为图下所示中的值,如果出现“回调地址没有加到安全域名列表中,请到腾讯微卡后台进行添加”,请把域名地址添加到业务域名中,如需多个请用分号隔开。

上架流程图

# 3、管理后台

自建应用如无管理后台可忽略此节,有管理后台并且无自己的登录验证体系的需参考此节处理。因为一旦应用管理后台地址泄漏,对方可随意进入管理后台修改后台数据存在安全隐患,为了管理端数据安全腾讯微卡提供了获取管理员登录态接口。

1.1 管理后台oauth地址:

假设应用管理后台地址是: http://www.example.com/index 管理后台oauth地址就是: https://uni.weixiao.qq.com/open/auth/manager-connect?app_key=APPKEY&redirect_uri=http://www.example.com/index

1.2 实现步骤: 应用方首先跳转到管理后台oauth地址,此地址由腾讯微卡oauth授权链接带上跳转地址参数redirect_uri组成,redirect_uri为应用管理后台地址。
oauth完成后腾讯微卡会跳转到应用管理后台地址并会带上wxcode参数,应用方可根据wxcode获取当前登录管理员身份态。如能正常获取到本校管理员登录态则进入应用管理后台地址,如获取异常则不能进入。详情请参考 获取管理员信息。oauth完成后跳转链接:http://www.example.com/index&wxcode=WXCODE&state=STATE

1.3 注意事项: 跳转站点和内嵌iframe的管理地址是一样的,内嵌iframe形式由于腾讯微卡站点为https所以要求应用站点必须是https,跳转站点形式无此要求。
内嵌iframe形式要求应用内嵌页面的设计风格保持和腾讯微卡同步,详情请参考 页面样式规范

# 4、移动端

# H5类应用:

H5应用内如需实名认证信息则需要调用身份认证,详情请参考 应用调用用户身份认证。school_code参数为学校/企业的学校/企业标识码,查看学校/企业标识码