English
名词解释
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，优先手机 |