已删除：反欺诈

本文档仅适用于3.0以前的gysdk，3.0以后的版本已经删除了反欺诈相关的功能接口。

前言

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

功能说明

反欺诈主要用于识别设备风险等级

提供两种接入方式，请业务方根据自身特点进行选择。

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

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

整体流程

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

接口列表

API 类名: com.getui.gysdk.GYManager

1、注册保护

接口名称

checkRegister

输入参数

开发者通过类 CheckBuilder.Builder 根据以下参数构造 CheckBuilder 对象，通过调用API public void checkRegister(CheckBuilder builder, GyCallBack callBack)，注册风险等级在 GyCallBack 回调中。

输出参数

类 GYResponse 参数说明：

msg中包含信息说明：

示例代码

CheckBuilder.Builder builder = new CheckBuilder.Builder("Appid");
builder.setImei("IMEI");
builder.setAccount("Account");

GYManager.getInstance().checkRegister(builder.build(), new GyCallBack() {
   @Override
   public void onSuccess(GYResponse response) {
       Log.d(TAG, "onSuccess:" + response.toString());
   }

   @Override
   public void onFailed(GYResponse response) {
       Log.d(TAG, "onFailed:" + response.toString());
   }
});

返回示例

{
 gyuid='null',
 reqId='null', 
 success=true, 
 code=20000, 
 msg='{
    "riskType"[],
    "level":"0",
    "ip":"192.168.5.17",
    "ipType":"",
    "token":"GY-AF-20180918-3K2VLXkLvk5nl7JsJxHZQ6"
    }', 
 validate='null'
}

2、登录保护

接口名称

checkLogin

输入参数

开发者通过类 CheckBuilder.Builder 根据以下参数构造 CheckBuilder 对象，通过调用API public void checkLogin(CheckBuilder builder, GyCallBack callBack)，注册风险等级在 GyCallBack 回调中。

输出参数

类 GYResponse 参数说明：

msg中包含信息说明：

示例代码

CheckBuilder.Builder builder = new CheckBuilder.Builder("Appid");
builder.setImei("IMEI");
builder.setAccount("Account");

GYManager.getInstance().checkLogin(builder.build(), new GyCallBack() {
    @Override
    public void onSuccess(GYResponse response) {
        Log.d(TAG, "onSuccess:" + response.toString());
    }

    @Override
    public void onFailed(GYResponse response) {
        Log.d(TAG, "onFailed:" + response.toString());
    }
});

返回示例

{
 gyuid='null',
 reqId='null', 
 success=true, 
 code=20000, 
 msg='{
    "riskType"[],
    "level":"0",
    "token":"GY-AF-20180918-3K2VLXkLvk5nl7JsJxHZQ6"
    }', 
 validate='null'
}

3、创建GyCallBack 接收回调

public interface GyCallBack {

    /**
     * description:请求成功.
     */     
    void onSuccess(GYResponse response);

    /**
     * description:请求失败.
     */
    void onFailed(GYResponse response);

}

• 类 GYResponse 属性详细说明：

状态码

请参考状态码汇总说明