反欺诈

前言

进行反欺诈接入前请先完成SDK的接入与初始化

如果无需使用一键认证功能，请联系文档中心右侧“技术咨询”获取精简包

功能说明

反欺诈主要用于识别设备风险等级
提供两种接入方式，请业务方根据自身特点进行选择。

• 客户端主动触发模式
  客户端在注册、登录时分别调用注册保护、登录保护接口。此种方式适合防范电商刷单、秒杀活动的防范。

• 服务端校验模式
  客户端只需完成初始化操作，获取gyuid（设备标识），服务端根据业务需要，定期根据gyuid获取设备风险等级。适用于新闻资讯类APP

整体流程

• 注册保护、登录保护整体流程

接口列表

接口说明

1、注册保护接口

接口描述

/**
 注册保护接口

 @param checkModel 校验模型
 @param callback 通用接口回调
 */
+ (void)checkRegister:(GyCheckModel *)checkModel withCallback:(GyVerifyCallback)callback;

输入参数

开发者通过类 GyCheckModel 根据以下参数构造 GyCheckModel 对象，通过调用API + (void)checkRegister:(GyCheckModel *)checkModel withCallback:(GyVerifyCallback)callback;，注册风险等级在 GyVerifyCallback 回调中。

验证接口回调参数说明

回调data中包含信息说明：

请求示例

    GyCheckModel *model = [[GyCheckModel alloc]init];
    model.account = @"69B64959969AF7DB11C5ED182495FB2E";
    model.email = @"69B64959969AF7DB11C5ED182495FB2E";
    model.pn = @"6E3652F544C1352516CF1997039F0660";
    model.pwd = @"E10ADC3949BA59ABBE56E057F20F883E";
    model.nickName = @"nickName";
    model.registerTime = @"1521440310";
    model.runEnv = @"4";
    model.moveCount = @"1";
    model.clickCount = @"3";
    model.keyCount = @"10";
    model.operatingTime = @"60";
    model.ip = @"192.168.1.3";
    model.appVer = @"1.1.0";
    model.mac = @"";
    model.idfa = @"1E2DFA89-496A-47FD-9941-DF1FC4E6484A";
    model.referrer = @"https://www.getui.com";
    model.xForwardFor = @"https://www.getui.com";
    model.result = @"1";
    model.reason = @"0";
    [[CommonToastHUD sharedInstance] showActivityView:@"正在发送请求"];
    [GeYanSdk checkRegister:model withCallback:^(NSDictionary *verifyDictionary) {
        [[CommonToastHUD sharedInstance] hideActivityView];
        NSInteger resultCode = [verifyDictionary[@"result"]integerValue];
        if (resultCode == 20000) {
            [[CommonToastHUD sharedInstance]showTips:verifyDictionary[@"msg"]];
        }else{
            [[CommonToastHUD sharedInstance]showTips:[NSString stringWithFormat:@"Fail with code : %ld,msg : %@",resultCode,verifyDictionary[@"msg"]]];
        }    }];

结果回调示例

{
    data =    {
        data =    {
            // 风险等级
            level = 2;
            // 风险类型
            riskType =    (
                3,
                2
            );
            // 服务端查询反欺诈结果凭证
            token = "GY-AF-20180614-r6Dwt1do4t7UAX2nIccZV";
        };
        msg = "\U6210\U529f";
        result = 20000;
    };
    errno = 0;
}

2、登录保护接口

接口描述

/**
 登录保护接口

 @param checkModel 校验模型
 @param callback 通用接口回调
 */
+ (void)checkLogin:(GyCheckModel *)checkModel withCallback:(GyVerifyCallback)callback;

输入参数

开发者通过类 GyCheckModel 根据以下参数构造 GyCheckModel 对象，通过调用API + (void)checkLogin:(GyCheckModel *)checkModel withCallback:(GyVerifyCallback)callback;，注册风险等级在 GyVerifyCallback 回调中。

验证接口回调参数说明

回调data中包含信息说明：

请求示例

    GyCheckModel *model = [[GyCheckModel alloc]init];
    model.account = @"69B64959969AF7DB11C5ED182495FB2E";
    model.email = @"69B64959969AF7DB11C5ED182495FB2E";
    model.pn = @"6E3652F544C1352516CF1997039F0660";
    model.pwd = @"E10ADC3949BA59ABBE56E057F20F883E";
    model.nickName = @"nickName";
    model.registerTime = @"1521440310";
    model.loginTime = @"1521440310";
    model.runEnv = @"4";
    model.moveCount = @"1";
    model.clickCount = @"3";
    model.keyCount = @"10";
    model.operatingTime = @"60";
    model.ip = @"192.168.1.3";
    model.appVer = @"1.1.0";
    model.mac = @"";
    model.idfa = @"1E2DFA89-496A-47FD-9941-DF1FC4E6484A";
    model.referrer = @"https://www.getui.com";
    model.xForwardFor = @"https://www.getui.com";
    model.result = @"1";
    model.reason = @"0";
    model.loginType = @"1";
    [[CommonToastHUD sharedInstance] showActivityView:@"正在发送请求"];
     [GeYanSdk checkLogin:model withCallback:^(NSDictionary *verifyDictionary) {
        NSInteger resultCode = [verifyDictionary[@"result"]integerValue];
        [[CommonToastHUD sharedInstance] hideActivityView];
        if (resultCode == 20000) {
            [[CommonToastHUD sharedInstance]showTips:verifyDictionary[@"msg"]];
        }else{
            [[CommonToastHUD sharedInstance]showTips:[NSString stringWithFormat:@"Fail with code : %ld,msg : %@",resultCode,verifyDictionary[@"msg"]]];
        }
    }];

结果回调示例

{
    data =    {
        data =    {
            // 风险等级
            level = 2;
            // 风险类型
            riskType =    (
                3,
                2
            );
            // 服务端查询反欺诈结果凭证
            token = "GY-AF-20180614-r6Dwt1do4t7UAX2nIccZV";
        };
        msg = "\U6210\U529f";
        result = 20000;
    };
    errno = 0;
}

状态码

请参考状态码汇总说明