Tdarr项目中API端点变更的技术解析与替代方案

背景概述

在Tdarr项目从2.22.01版本升级到2.24.05版本后，用户发现原有的/api/v2/get-client-db端点不再可用。这个变更实际上是项目团队为了提升系统稳定性和性能而做出的有意识调整。

被移除的API端点

原有两个API端点已被移除：

1. /api/v2/get-client-db
2. /api/v2/export-csv

这两个端点被移除的主要原因是它们会返回大量数据，在处理大型媒体库时可能导致服务器崩溃。特别是当需要返回的数据量超过服务器处理能力时，会严重影响系统稳定性。

技术改进方案

项目团队提供了更现代的替代方案，采用分页查询和过滤机制，显著提升了大数据量场景下的系统稳定性：

1. 状态表格查询

新的API端点/api/v2/client/status-tables支持分页查询和条件过滤，可以安全地获取各类状态表格数据。系统将状态表格编号为table0到table6，分别对应不同的处理状态：

• table0: 保留(Hold)表格
• table1: 转码队列(Transcode Queue)表格
• ...(其他表格以此类推)

典型查询示例：

{
    "start": 0,
    "pageSize": 100,
    "filters": [],
    "sorts": [],
    "opts": {
        "table": "table1"
    }
}

2. 高级查询功能

新API支持丰富的查询参数：

• start: 分页起始位置
• pageSize: 每页数据量
• filters: 过滤条件数组
• sorts: 排序条件数组
• opts: 额外选项

3. 数据导出功能

虽然移除了专门的CSV导出端点，但新API通过添加csv选项仍支持CSV格式导出：

{
    "opts": {
        "table": "table1",
        "csv": true
    }
}

迁移建议

对于需要使用原功能的开发者，建议：

1. 评估数据量大小，合理设置pageSize参数
2. 对于大数据量场景，采用分页查询方式
3. 充分利用过滤和排序功能提高查询效率
4. 需要CSV导出时使用新的csv选项

技术影响评估

这一变更从架构角度看是积极的改进：

1. 解决了大数据量导致的内存溢出风险
2. 提供了更灵活的查询能力
3. 保持了功能的向后兼容性
4. 改善了整体系统稳定性

开发者需要调整现有代码以适应新的API规范，但长远来看这将带来更好的系统可靠性和查询性能。