名词解释

challenge

极验交互的流水号,标志一次交互判断流程。由极验客户端的SDK发送数据后从极验的服务器获得,可用来查询获得当次交互的相关安全信息。注意,一次交互极验判断完成后,该参数有10min有效期,请在有效期内查询极验的安全校验结果。

id

极验业务安全产品的公钥。32位字符串, 对公众可见,用来标记某个交互场景,同时方便网站主针对不同场景设置不同的安全校验逻辑。

key

极验业务安全产品的私钥。32位字符串, 每个id对应一个私钥, 在后台云验证需要此私钥来进行数据加密, 保障验证安全。请网站主妥善保管注册的私钥。

常见约定

业务字段约定

极验针对不同场景使用了不同的模型处理,需要业务方提供不同的业务数据。

参数名称 是否必须 传入接口 类型 可选值
idType 必须 API2(服务端gt_verify) Int 可选用户标识符的类型:
1:手机号;2:邮箱;3:昵称;4:UID,用户id;0:其他
idValue 必须 API2(服务端gt_verify) String idType所对应的具体值
interactive 必须 API1(客户端gt_judgement) Int 可选交互场景类型:
1:注册;2:登录;3:短信接口;4:领券\抽奖;5:下单;6:发帖评论;0:其他
attr 选传 API1(客户端gt_judgement) list 携带自定义的业务信息,用以辅助极验的判断。

不同场景上传内容约定

场景名称 interactive attr idType idValue
登录 2 {按需回传重要信息} 1/2/4 手机/邮箱/用户id,优先手机
注册 1 {“source”:”用户来源渠道链接或标记”} 1/2 手机/邮箱,优先手机
营销:任务式 0 {
“taskId”:”任务id,用来区分不同的任务类型”,
”rewards”:”任务奖励发放数量,无需单位”
}
1/2/4 手机/邮箱/用户id,优先手机
营销:领券类 4 {
“couponType”:”优惠券的类型”,
”couponAmount”:”优惠券价值”
}
1/2/4 手机/邮箱/用户id,优先手机
营销:裂变式 0 {
“inviter”:”邀请该用户的人”,
”identifier”:”该用户自己的邀请码”
}
1/2/4 手机/邮箱/用户id,优先手机
营销-投票类 0 {“targetId”:”投票的目标id”} 1/2/4 手机/邮箱/用户id,优先手机
营销-资源保护 0 {“resourceId”:”资源的代表id,视频id、文章id等”} 1/2/4 手机/邮箱/用户id,优先手机