活动资格接口鉴权

概述：

编辑器对活动主办方提供针对用户是否具有参与资格、作品访问资格、领取奖品资格等提供鉴权。此功能中活动h5会发送自定义鉴权参数到对应鉴权接口（见下方鉴权接口协议部分）进行鉴权，具体接口需要主办方自行实现。

我需要准备什么？

本授权功能需接入方企业先在营销云开通 “数据集成” 模块，并获得 “自建应用” 的使用权限。
自建应用内申请开通编辑器 → 自定义接口鉴权，后续联系管理员审核通过。应用配置界面如下：

添加后，点击“编辑”进入对应设置页
完成配置后，点击“保存”即可。
在编辑器中，可在作品预览页面开启作品访问限制鉴权，或在活动玩法配置中对应限制选项中进行配置，配置界面如下：
此配置案例下，在用户访问作品时，会调用主办方配置的鉴权接口，发送在数据集成自定义接口鉴权中配置好的字段，通过接口返回结果来判断用户是否具有作品访问资格。

鉴权接口协议：

鉴权接口完整URL：自建应用方自己的 domain+URI

例如： https://aa.bb.com/api/xx/checkDataAuth

接口协议：HTTPS

HTTP请求方式：POST

consumes ：application/json

produces ：application/json

接口响应时间：3秒以内，最好能达到百毫秒级，满足高并发场景。活动H5方调用鉴权接口最多等待3秒，超过3秒没有响应，自动放弃请求，判定为鉴权失败。

接口参数说明表：

字段名称	字段类型	是否必传	字段说明
appId	String	true	作品id
componetId	String	false	插件id
flowId	String	false	策略id
interfaceName	string	false	接口鉴权名称
userParam	Object	true	用户参数。对应自建应用中的系统参数中的固定参数
audid	string	true	用户档案id
appInstanceId	string	false	自建应用的id
identityId	string	false	自建应用的识别的身份id
identityType	string	false	自建应用的身份类型
realName	string	false	真实姓名
phone	string	false	手机号码
address	string	false	地址信息
device	string	false	手机型号 ios/Android
markFlag	integer	false	是否星标 1是 0否
payFeature	String	false	消费特点
sex	int	false	性别 1男 2女
customFields	list	false	自定义字段可能会存在多个。对应工作台中的用户-字段管理中的字段
fieldId	string	false	自定义字段ID
fieldType	string	false	自定义字段类型 1 文本输入(默认) 2 单选 3 复选 4 数值
fieldValue	list	false	自定义字段值
authParams	list	true	鉴权参数集合。对应工作台中的校验参数列表，用于客户侧校验的字段
chineseName	string	true	参数中文名
englishName	string	true	参数英文名
paramType	string	true	参数类型文本：可输入string类型，支持字母+数字+下划线+中文数值：支持双精度小数，整数；支持大于、大于等于、小于等于、小于、区间（闭区间）单选、复选：取值选项标识参数值去string类型，单选仅满足其中之一；复选可以满足所有选项，也可满足其中之一
values	list	false	参数值
option	string	false	多选值
operator	string	false	操作符(EQ（相等）、GT（大于）、GTEQ（大于等于）、LT（小于）、LTEQ（小于等于）、NEQ（不等）、IN（在枚举范围内）、ALL（全部）、BETWEEN（范围比较） )

接口响应参数说明：

字段名

类型

必选

说明

code

string

true

结果返回码，200为正常，其余都为错误

msg