App环境授权

概述：

本文档为第三方使用App接入兔展H5活动作品的授权接入文档。

我需要准备什么？

1. 本授权功能需接入方企业先在兔展营销云开通 “数据集成” 模块，并获得 “自建应用” 的使用权限。
   
   
2. 自建应用内申请开通 编辑器 → APP环境授权，后续联系管理员审核通过。应用配置界面如下：
   
   
   
   注意：应用权限必须配置UA识别符，作品内会先获取浏览器UA再匹配设置好的识别符，如果匹配到才能识别为App环境
   例如某App中WebView有特殊标识符xxxApp，是属于接入方App自定义的标识性字符，此时识别User-Agent栏目填入“xxxApp”即可，无需填写完整的UA
   
   
3. 配置好UA后，上传授权SDK（详见示例代码部分），点击保存即可

授权流程

用户进入活动作品的时候，先会触发鉴权逻辑，检测自建应用是否在有效期内等，如果通过则走授权流程，确保自建应用为有效状态。

App环境授权第三方规范

标准协议如表格所示，第三方需按此表格中的协议实现JS SDK代码包，兔展活动页面会在合适的时机来主动调用，JS SDK命名空间固定为：AppAuthorization

{
	"jcappid": "集成的应用ID", // 数据集成应用ID
	"identityId": "身份ID", // 用户传过来的识别ID
	"identityType": "身份类型", // ID类型标识，phone 手机、uid 用户ID，openid 微信openid
	"userName": "用户名称", // 可选字段
    "avatar": "用户头像", // 可选字段
    "phone": "手机号", // 可选字段
    "sex": "性别", // 可选字段 值为 1 时是男性，值为 2 时是女性，值为 0 时是未知
}

示例代码如下所示：

const AppAuthorization = {
	isLogin() {
		return false;
	},
	getUserInfo() {
		return {
			"jcappid":"集成的应用ID"，
			"identityId":"身份ID"，//传过来的识别ID
			"identityType"："身份类型", //如 phone 手机、uid 用户ID，openid 微信openid
			"userName": "用户名称", // 可选字段
            "avatar": "用户头像", // 可选字段
            "phone": "手机号", // 可选字段
            "sex": "性别", // 可选字段 值为 1 时是男性，值为 2 时是女性，值为 0 时是未知
		};
	},
};
window.AppAuthorization = AppAuthorization;