H5 微应用接入

应用场景

当开发者需要将自己的应用能力集成到云链超级 APP 平台中时，可以通过 H5 微应用的形式将服务能力发布到开放平台的应用市场中，并由相关管理员触发集成操作

H5 微应用为开发者提供了定制明源 APP 应用的能力，开发者可基于明源云链开放平台的开放能力，根据实际需要定制开发自己的企业应用。同时基于开放平台的授权机制，降低开发者的对接成本和安全风险

接入前准备

1. 注册开发者账号

使用云链开放平台首先需要开发者拥有自己的开放平台账号。相关注册流程可查看 注册开发者账号 章节的内容

2. 创建开发者应用

拥有开发者账号后，开发者需要在账号下创建属于自己的开放平台应用。每个应用拥有着属于自己的独一无二的 AppKey、AppSecret，在开放平台上使用各种开放能力时，均会有不同程度上的使用到这个应用配置。具体的应用创建流程可查看 创建开发者应用 章节的内容

3. 开通微应用

在云链开放平台中的应用默认是不拥有微应用属性的，需要开发者根据自己的实际需要进行微应用的开通。只有正式开通并发布微应用后，开发者的微应用才算是能正常被使用。具体的微应用开通流程可查看 微应用开发

4. 启用通行证

如果开发者的微应用并不需要获取用户信息，可以跳过此步骤。如果需要获取用户信息打的话，则需要按照开放平台的用户授权机制完成免登陆授权

开放平台的用户身份认证能力由统一通行证提供，因此开发者需要给自己的应用激活启用统一通行证。具体的统一通行证启用流程可查看 开通通行证

开发指引

1. 微应用授权登录

在微应用上进行免密的授权登录操作，需要拿到主应用颁发的授权临时码。授权码的生成及使用机制基于 OAuth2.0 协议来实现。通过利用授权码调用统一通行证下的 授权登录 接口完成用户免登陆流程，登录后开发者将会获得与用户登录态关联的授权令牌数据（访问令牌+刷新令牌）

为避免微应用频繁执行免密授权登录逻辑，在微应用拿到自己的授权令牌数据后，可根据相关令牌刷新接口进行登录态的续期，正常情况下刷新令牌有效期为 30 天

2. 使用 APP 原生能力

在明源超级 APP 上，我们提供了相对应的 JS-SDK 来开放一些原生控件的能力。开发者可根据需要接入使用。JS-SDK 的使用说明可查看 JSSDK 使用

3. 消息管理

在明源超级 APP 上，我们目前提供了两种与消息有关的开放能力：业务消息/待办的新增、APP 消息推送。详细的消息管理机制可查看 消息管理说明

相关 API 清单