如何获取Copyleaks SDK的Java使用示例代码？

前置依赖配置 #

首先在项目的pom.xml中引入SDK依赖：

<dependency>
    <groupId>com.copyleaks</groupId>
    <artifactId>copyleaks-java-sdk</artifactId>
    <version>最新官方稳定版</version>
</dependency>

核心功能代码示例 #

以下代码覆盖身份认证、提交文本检测、获取检测结果全流程：

import com.copyleaks.sdk.CopyleaksAPI;
import com.copyleaks.sdk.exceptions.CopyleaksException;
import com.copyleaks.sdk.models.submissions.SubmissionModel;
import com.copyleaks.sdk.models.submissions.SubmitTextResult;
import com.copyleaks.sdk.models.results.ResultItem;
import java.util.UUID;

public class CopyleaksIntegrationDemo {
    // 替换为自身账号的认证信息
    private static final String COPYLEAKS_ACCOUNT = "你的账号绑定邮箱";
    private static final String COPYLEAKS_API_KEY = "你的API密钥";

    public static void main(String[] args) {
        try {
            // 1. 初始化SDK客户端，完成身份认证
            CopyleaksAPI copyleaksClient = new CopyleaksAPI(COPYLEAKS_ACCOUNT, COPYLEAKS_API_KEY);

            // 2. 生成唯一检测任务ID，用于后续查询结果
            String scanTaskId = UUID.randomUUID().toString();

            // 3. 构造检测请求参数
            SubmissionModel detectionParams = new SubmissionModel();
            detectionParams.setText("此处填入待检测的文本内容");
            detectionParams.setSandbox(true); // 测试环境开启沙箱模式，不消耗正式额度
            // 可按需追加其他配置，比如检测语言、排除来源、敏感信息脱敏等参数

            // 4. 提交文本检测任务
            SubmitTextResult submitResponse = copyleaksClient.getCopyleaks().submit().text(scanTaskId, detectionParams);
            System.out.println("检测任务提交成功，任务ID：" + scanTaskId);

            // 5. 获取检测结果
            // 测试场景可临时用延迟等待逻辑，生产环境推荐使用webhook接收检测完成回调
            Thread.sleep(20000); // 等待时长可根据待检测文本长度调整
            ResultItem[] detectionResults = copyleaksClient.getCopyleaks().scans().result(scanTaskId);

            // 6. 解析结果
            for (ResultItem item : detectionResults) {
                System.out.println("匹配来源地址：" + item.getUrl());
                System.out.println("内容匹配度：" + item.getPlagiarismPercent() + "%");
                // 可进一步获取匹配片段位置、原文对应内容等详细信息
            }
        } catch (CopyleaksException e) {
            System.err.println("Copyleaks接口调用异常：错误码" + e.getErrorCode() + "，错误信息：" + e.getMessage());
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
    }
}

注意事项 #

• 沙箱模式仅用于集成测试，返回的结果为模拟数据，正式上线前需将sandbox参数设置为false
• 生产环境不要硬编码账号密钥等敏感信息，建议存入环境变量或加密配置中心读取
• 大文本、批量检测场景不要使用轮询方式获取结果，提前配置回调地址接收检测完成通知即可

内容的提问来源于stack exchange，提问作者Jatin Sutaria