自建应用接入规范

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

1、如何创建自建应用

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

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形式要求应用内嵌页面的设计风格保持和腾讯微卡同步，详情请参考 页面样式规范 (opens new window)。

4、移动端

H5类应用：

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