概述:
兔展对活动主办方提供针对用户是否具有参与资格、作品访问资格、领取奖品资格等提供鉴权。此功能中兔展活动h5会发送自定义鉴权参数到对应鉴权接口(见下方鉴权接口协议部分)进行鉴权,具体接口需要主办方自行实现。编辑器对活动主办方提供针对用户是否具有参与资格、作品访问资格、领取奖品资格等提供鉴权。此功能中活动h5会发送自定义鉴权参数到对应鉴权接口(见下方鉴权接口协议部分)进行鉴权,具体接口需要主办方自行实现。
我需要准备什么?
- 本授权功能需接入方企业先在兔展营销云开通 本授权功能需接入方企业先在营销云开通 “数据集成” 模块,并获得 “自建应用” 的使用权限。
- 自建应用内申请开通 编辑器 → 自定义接口鉴权,后续联系管理员审核通过。应用配置界面如下:
添加后,点击“编辑”进入对应设置页 - 完成配置后,点击“保存”即可。
- 在编辑器中,可在作品预览页面开启作品访问限制鉴权,或在活动玩法配置中对应限制选项中进行配置,配置界面如下:
- 此配置案例下,在用户访问作品时,会调用主办方配置的鉴权接口,发送在数据集成自定义接口鉴权中配置好的字段,通过接口返回结果来判断用户是否具有作品访问资格。
...
produces :application/json
...
接口响应时间:3秒以内,最好能达到百毫秒级,满足高并发场景。活动H5方调用鉴权接口最多等待3秒,超过3秒没有响应,自动放弃请求,判定为鉴权失败。
接口参数说明表:
字段名称 | 字段类型 | 是否必传 | 字段说明 |
---|---|---|---|
interfaceName | string | false | 接口鉴权名称 |
userParam | Object | true | 用户参数 |
audid | string | true | 客户档案id用户档案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(范围比较) ) |
...