背景说明:

兔展支持限制当前用户是否有参与某个玩法或者进入作品的资格,由第三方系统进行控制。

功能说明:

准备工作

1、申请自建应用,点击新建应用;

2、填写应用名称,选择【编辑器】——【自定义接口鉴权】,点击申请开通,等待审核;

3、审核通过后,显示如下,点击【添加接口】,选择【编辑】,记得点击保存哟;

4、选择鉴权配置界面;

5、点击确认、保存即可,记得自建应用也要点保存哟;

编辑器配置:

1、选择某个玩法;

2、在参与资格中,选择接口鉴权;

3、选择自建应用;

4、选择鉴权方式;

5、可以正常使用活动参与资格鉴权的功能。

鉴权接口协议:

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

(兔展方 ---调用---> 第三方)

接口协议:HTTPS

HTTP请求方式:POST

consumes :application/json

produces :application/json

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

接口参数说明表:

字段名称

字段类型

是否必传

字段说明

interfaceName

stringtrue接口鉴权名称

checkType

stringfalse

校验类型: 

false:自定义设置 

true:外部接口回调

externalConditionUrl

stringfalse外部接口回调-获取鉴权条件URL

externalInformUrl

Stringfalse外部接口回调-保存通知接口

externalConfigId

stringfalse外部接口配置的ID

externalConfigOperator

stringfalse外部条件操作符

externalConfigValues

list<list<string>>false外部条件值
userParamObjecttrue用户参数
└─ audidstringtrue客户档案id
└─ openidstringfalseopenid
└─ appIdstringtrue作品id
└─ componentIdstringfalse组件id
└─ flowIdstringfalse流程策略id
└─ appInstanceIdstringfalse自建应用的id
└─ identityIdstringfalse自建应用的识别的身份id
└─ identityTypestringfalse自建应用的身份类型
└─ realName stringfalse真实姓名
└─ phone   stringfalse手机号码
└─ addressstringfalse地址信息
└─ devicestringfalse手机型号 ios/Android
└─ markFlagintegerfalse

是否星标 1 0

└─ payFeatureStringfalse消费特点
└─ sexintfalse性别 1男 2女

└─ customFields

listfalse自定义字段可能会存在多个

└─└─ fieldId

stringfalse

自定义字段ID

└─└─ fieldType

stringfalse

自定义字段类型 1 文本输入(默认) 2 单选 3 复选 4 数值

└─└─ fieldValue

list<string>false

自定义字段值

authParams

listtrue鉴权参数集合
└─ chineseNamestringtrue参数中文名
└─ englishNamestringtrue参数英文名

└─ paramType

stringtrue

参数类型:

文本-text,数值-number,多选-select,单选-checkbox,区间-area

(文本:可输入string类型,支持字母+数字+下划线+中文

数值:支持双精度小数,整数;支持大于、大于等于、小于等于、小于、区间(闭区间) 

单选、复选: 取值 选项标识参数值去string类型,单选仅满足其中之一;复选可以满足所有选项,也可满足其中之一 )

└─ valuesObjectfalse

参数值

└─ option

List<string>false多选值
└─ └─ keystringfalse复选框key
└─ └─ valuestringfalse复选框value
└─ operatorstringfalse操作符(EQ(相等)、GT(大于)、GTEQ(大于等于)、LT(小于)、LTEQ(小于等于)、NEQ(不等)、IN(在枚举范围内)、ALL(全部)、BETWEEN(范围比较) )

接口响应参数说明:

字段名

类型

必选

说明

codestringtrue

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


msg

stringtrue结果信息。被调用方响应的信息