设备风险识别API接入说明

版本选型建议

• 基础版：适用于仅需风险标签判定的场景，例如识别设备是否为模拟器、是否 Root 或多开等基础风控需求。

• 增强版：适用于需要设备唯一 ID 进行跨会话追踪，或需要将日志投递至 SLS 进行深度分析的场景。

Service 参数

Service 参数用于指定调用的服务版本。不同版本对应的 Service 参数值如下：

ServiceParameters 参数

ServiceParameters 为具体的业务请求参数，为 JSON 格式，对应公共参数中ServiceParameters字段。以下为设备风险识别服务（含基础版、增强版）需传入的请求参数。

设备 ID

详见返回参数 Data 中extend字段，仅增强版支持返回设备唯一 ID。

设备风险标签

详见返回参数 Data 中tags字段，若返回多个标签则以英文逗号分割，部分标签含义如下：

更多信息，参见公共返回参数。

错误码

Maven 依赖

Java Maven 依赖：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-saf</artifactId>
    <version>3.0.1</version>
</dependency>

Java Maven 推荐依赖仲裁：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <optional>true</optional>
    <version>4.5.25</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.68.noneautotype</version>
</dependency>
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.3</version>
</dependency>
<dependency>
    <groupId>io.opentracing</groupId>
    <artifactId>opentracing-util</artifactId>
    <version>0.31.0</version>
</dependency>

Java SDK 源码

// 阿里云账号 AccessKey 拥有所有 API 的访问权限，建议使用 RAM 用户进行 API 访问或日常运维。
// 请勿将 AccessKey ID 和 AccessKey Secret 保存到工程代码中，以免导致 AccessKey 泄露，威胁账号下所有资源的安全。
// 本示例通过从环境变量中读取 RAM 用户 AccessKey 来实现 API 访问的身份验证。运行本示例代码前，请确认已配置以下环境变量：ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET。
// 创建 DefaultAcsClient 实例并初始化，仅需初始化一次
DefaultProfile profile = DefaultProfile.getProfile(
    "cn-shanghai", // 地域 ID，国内推荐 cn-shanghai，需和端 SDK 上报域名对应
    System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),     // RAM 用户的 AccessKey ID
    System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")  // RAM 用户 Access Key Secret
);
// http 连接池相关配置
HttpClientConfig clientConfig = HttpClientConfig.getDefault();
clientConfig.setMaxRequestsPerHost(6);
clientConfig.setMaxIdleConnections(20);
// http 超时时间配置
clientConfig.setReadTimeoutMillis(10000);
clientConfig.setConnectionTimeoutMillis(3000);
profile.setHttpClientConfig(clientConfig);
IAcsClient client = new DefaultAcsClient(profile);

// 发起请求
ExecuteRequestRequest executeRequestRequest = new ExecuteRequestRequest();
// 如需指定特殊版本号，可在此处调整，默认为 2019-05-21
executeRequestRequest.setVersion("2019-05-21");
// 指定请求方法
executeRequestRequest.setSysMethod(MethodType.POST);
// 指定协议，目前仅支持 HTTPS
executeRequestRequest.setSysProtocol(ProtocolType.HTTPS);

// 设备风险识别服务的产品码：device_risk 或 device_risk_pro，详见文档"版本介绍"表格中 Service 参数行
String service = "device_risk";
executeRequestRequest.setService(service);
// 业务参数，按需设置，不需要的参数无需传入
Map<String, Object> serviceParams = new HashMap<String, Object>();
// deviceToken 为必填参数
serviceParams.put("deviceToken", "TK******************");
executeRequestRequest.setServiceParameters(JSONObject.toJSONString(serviceParams));
executeRequestRequest.setAcceptFormat(FormatType.JSON);

try {
    ExecuteRequestResponse httpResponse = client.getAcsResponse(executeRequestRequest);
    System.out.println("httpResponse:" + JSONObject.toJSONString(httpResponse));
} catch (Exception e) {
    e.printStackTrace();
}

验证调用结果

调用 SDK 发起请求后，可通过以下方式验证集成是否成功：

• 返回Code=200表示请求成功。

• 返回Data中包含tags字段，表示设备风险检测结果已正常返回。