Server API

List<AppsResponseVO> apps(String mode, String name);

@Resource
private DifyServer difyServer;

@Test
public void testGetApps() {
    // 获取所有应用
    List<AppsResponseVO> apps = difyServer.apps("");

    // 获取带名称过滤的应用
    List<AppsResponseVO> filteredApps = difyServer.apps("myApp");
}

AppsResponseResult apps(AppsRequest appsRequest);

@Resource
private DifyServer difyServer;

@Test
public void testGetAppsPaginated() {
    // 创建分页请求
    AppsRequest request = new AppsRequest();
    request.setPage(1);
    request.setLimit(10);
    request.setMode("chat");
    request.setName("myApp");
    request.setIsCreatedByMe(true);

    // 获取分页应用列表
    AppsResponseResult result = difyServer.apps(request);

    System.out.println("当前页: " + result.getPage());
    System.out.println("每页数量: " + result.getLimit());
    System.out.println("总数: " + result.getTotal());
    System.out.println("是否有更多: " + result.getHasMore());
    System.out.println("数据大小: " + result.getData().size());
}

AppsResponseVO app(String appId);

@Resource
private DifyServer difyServer;

@Test
public void testGetApp() {
    AppsResponseVO app = difyServer.app("app-123456789");
}

List<ApiKeyResponseVO> getAppApiKey(String id);

@Resource
private DifyServer difyServer;

@Test
public void testGetAppApiKeys() {
    List<ApiKeyResponseVO> apiKeys = difyServer.getAppApiKey("app-123456789");
}

List<ApiKeyResponseVO> initAppApiKey(String id);

@Resource
private DifyServer difyServer;

@Test
public void testInitAppApiKey() {
    List<ApiKeyResponseVO> apiKeys = difyServer.initAppApiKey("app-123456789");
}

void deleteAppApiKey(String appId, String apiKeyId);

@Resource
private DifyServer difyServer;

@Test
public void testDeleteAppApiKey() {
    // 删除指定应用的API密钥
    difyServer.deleteAppApiKey("app-123456789", "key-789012345");
}

List<DatasetApiKeyResponseVO> getDatasetApiKey();

@Resource
private DifyServer difyServer;

@Test
public void testGetDatasetApiKeys() {
    List<DatasetApiKeyResponseVO> datasetApiKeys = difyServer.getDatasetApiKey();
}

List<DatasetApiKeyResponseVO> initDatasetApiKey();

@Resource
private DifyServer difyServer;

@Test
public void testInitDatasetApiKey() {
    List<DatasetApiKeyResponseVO> datasetApiKeys = difyServer.initDatasetApiKey();
}

void deleteDatasetApiKey(String apiKeyId);

@Resource
private DifyServer difyServer;

@Test
public void testDeleteDatasetApiKey() {
    // 删除指定的知识库API密钥
    difyServer.deleteDatasetApiKey("89f04b59-6906-4d32-a630-d2911d3b5fd8");
}

DifyPageResult<ChatConversationResponse> chatConversations(ChatConversationsRequest request);

@Resource
private DifyServer difyServer;

@Test
public void testGetChatConversations() {
    // 创建请求对象
    ChatConversationsRequest request = new ChatConversationsRequest();
    request.setAppId("app-123456789");
    request.setPage(1);
    request.setLimit(10);
    request.setStart("2025-10-23 00:00");
    request.setEnd("2025-10-30 23:59");
    request.setAnnotationStatus("all");
    request.setSortBy("-created_at");

    // 获取聊天会话列表
    DifyPageResult<ChatConversationResponse> result = difyServer.chatConversations(request);

    System.out.println("当前页: " + result.getPage());
    System.out.println("每页数量: " + result.getLimit());
    System.out.println("总数: " + result.getTotal());
    System.out.println("是否有更多: " + result.getHasMore());
    System.out.println("数据大小: " + result.getData().size());

    for (ChatConversationResponse conversation : result.getData()) {
        System.out.println("会话ID: " + conversation.getId());
        System.out.println("会话名称: " + conversation.getName());
        System.out.println("是否标注: " + conversation.isAnnotated());
    }
}

List<DailyConversationsResponse> dailyConversations(String appId, LocalDateTime start, LocalDateTime end);

@Resource
private DifyServer difyServer;

@Test
public void testGetDailyConversations() {
    String appId = "08534c1a-4316-4cd3-806d-bbbca03f58aa";
    LocalDateTime start = LocalDateTime.of(2025, 10, 23, 0, 0);
    LocalDateTime end = LocalDateTime.of(2025, 10, 30, 23, 59);

    // 获取每日对话统计
    List<DailyConversationsResponse> dailyStats = difyServer.dailyConversations(appId, start, end);

    if (dailyStats != null) {
        for (DailyConversationsResponse dailyStat : dailyStats) {
            System.out.println("日期: " + dailyStat.getDate());
            System.out.println("对话数量: " + dailyStat.getConversationCount());
        }
    }
}

List<DailyEndUsersResponse> dailyEndUsers(String appId, LocalDateTime start, LocalDateTime end);

@Resource
private DifyServer difyServer;

@Test
public void testGetDailyEndUsers() {
    String appId = "08534c1a-4316-4cd3-806d-bbbca03f58aa";
    LocalDateTime start = LocalDateTime.of(2025, 10, 23, 0, 0);
    LocalDateTime end = LocalDateTime.of(2025, 10, 30, 23, 59);

    // 获取每日终端用户统计
    List<DailyEndUsersResponse> dailyEndUsersStats = difyServer.dailyEndUsers(appId, start, end);

    if (dailyEndUsersStats != null) {
        for (DailyEndUsersResponse dailyStat : dailyEndUsersStats) {
            System.out.println("日期: " + dailyStat.getDate());
            System.out.println("终端用户数量: " + dailyStat.getTerminalCount());
        }
    }
}

List<AverageSessionInteractionsResponse> averageSessionInteractions(String appId, LocalDateTime start, LocalDateTime end);

@Resource
private DifyServer difyServer;

@Test
public void testGetAverageSessionInteractions() {
    String appId = "08534c1a-4316-4cd3-806d-bbbca03f58aa";
    LocalDateTime start = LocalDateTime.of(2025, 10, 23, 0, 0);
    LocalDateTime end = LocalDateTime.of(2025, 10, 30, 23, 59);

    // 获取平均会话交互统计
    List<AverageSessionInteractionsResponse> averageSessionInteractionsStats = difyServer.averageSessionInteractions(appId, start, end);

    if (averageSessionInteractionsStats != null) {
        for (AverageSessionInteractionsResponse dailyStat : averageSessionInteractionsStats) {
            System.out.println("日期: " + dailyStat.getDate());
            System.out.println("平均会话交互数: " + dailyStat.getInteractions());
        }
    }
}

List<TokensPerSecondResponse> tokensPerSecond(String appId, LocalDateTime start, LocalDateTime end);

@Resource
private DifyServer difyServer;

@Test
public void testGetTokensPerSecond() {
    String appId = "08534c1a-4316-4cd3-806d-bbbca03f58aa";
    LocalDateTime start = LocalDateTime.of(2025, 10, 23, 0, 0);
    LocalDateTime end = LocalDateTime.of(2025, 10, 30, 23, 59);

    // 获取每秒令牌统计
    List<TokensPerSecondResponse> tokensPerSecondStats = difyServer.tokensPerSecond(appId, start, end);

    if (tokensPerSecondStats != null) {
        for (TokensPerSecondResponse dailyStat : tokensPerSecondStats) {
            System.out.println("日期: " + dailyStat.getDate());
            System.out.println("每秒令牌数: " + dailyStat.getTps());
        }
    }
}

List<UserSatisfactionRateResponse> userSatisfactionRate(String appId, LocalDateTime start, LocalDateTime end);

@Resource
private DifyServer difyServer;

@Test
public void testGetUserSatisfactionRate() {
    String appId = "08534c1a-4316-4cd3-806d-bbbca03f58aa";
    LocalDateTime start = LocalDateTime.of(2025, 10, 23, 0, 0);
    LocalDateTime end = LocalDateTime.of(2025, 10, 30, 23, 59);

    // 获取用户满意度率统计
    List<UserSatisfactionRateResponse> userSatisfactionRateStats = difyServer.userSatisfactionRate(appId, start, end);

    if (userSatisfactionRateStats != null) {
        for (UserSatisfactionRateResponse dailyStat : userSatisfactionRateStats) {
            System.out.println("日期: " + dailyStat.getDate());
            System.out.println("用户满意度率: " + dailyStat.getRate());
        }
    }
}

List<TokenCostsResponse> tokenCosts(String appId, LocalDateTime start, LocalDateTime end);

@Resource
private DifyServer difyServer;

@Test
public void testGetTokenCosts() {
    String appId = "08534c1a-4316-4cd3-806d-bbbca03f58aa";
    LocalDateTime start = LocalDateTime.of(2025, 10, 23, 0, 0);
    LocalDateTime end = LocalDateTime.of(2025, 10, 30, 23, 59);

    // 获取令牌费用统计
    List<TokenCostsResponse> tokenCostsStats = difyServer.tokenCosts(appId, start, end);

    if (tokenCostsStats != null) {
        for (TokenCostsResponse dailyStat : tokenCostsStats) {
            System.out.println("日期: " + dailyStat.getDate());
            System.out.println("令牌数量: " + dailyStat.getTokenCount());
            System.out.println("总费用: " + dailyStat.getTotalPrice());
            System.out.println("货币类型: " + dailyStat.getCurrency());
        }
    }
}

List<DailyMessagesResponse> dailyMessages(String appId, LocalDateTime start, LocalDateTime end);

@Resource
private DifyServer difyServer;

@Test
public void testGetDailyMessages() {
    String appId = "08534c1a-4316-4cd3-806d-bbbca03f58aa";
    LocalDateTime start = LocalDateTime.of(2025, 10, 23, 0, 0);
    LocalDateTime end = LocalDateTime.of(2025, 10, 30, 23, 59);

    // 获取每日消息统计
    List<DailyMessagesResponse> dailyMessagesStats = difyServer.dailyMessages(appId, start, end);

    if (dailyMessagesStats != null) {
        for (DailyMessagesResponse dailyStat : dailyMessagesStats) {
            System.out.println("日期: " + dailyStat.getDate());
            System.out.println("消息数量: " + dailyStat.getMessageCount());
        }
    }
}