Immich-Go项目：从服务器获取支持的媒体类型扩展列表

在开源项目Immich-Go的开发过程中，实现了一个重要功能：从Immich服务器动态获取支持的媒体文件类型扩展列表。这项改进显著提升了客户端与服务器之间的兼容性和灵活性。

功能背景

Immich是一个自托管的照片和视频备份解决方案，而Immich-Go是其Go语言客户端。在媒体文件上传过程中，客户端需要知道服务器支持哪些文件类型。过去，这个信息可能是硬编码在客户端中的，但随着服务器端支持的媒体类型可能发生变化，这种静态方式会导致兼容性问题。

技术实现

通过调用服务器提供的API端点get-supported-media-types，客户端现在能够动态获取服务器当前支持的媒体文件扩展名列表。这个功能实现涉及以下几个关键技术点：

1. API调用：客户端向服务器发送HTTP请求，获取JSON格式的响应数据
2. 数据处理：解析服务器返回的媒体类型信息，提取有效的文件扩展名
3. 缓存机制：合理缓存获取到的扩展名列表，避免每次检查都发起网络请求
4. 错误处理：在网络请求失败时提供合理的回退机制

实现优势

这项改进带来了多方面的好处：

1. 动态适配：当服务器更新支持的媒体类型时，客户端无需更新即可自动适配
2. 减少维护成本：不再需要手动同步客户端和服务器的支持类型列表
3. 提高兼容性：确保客户端不会尝试上传服务器不支持的媒体格式
4. 更好的用户体验：在上传前就能准确判断文件是否会被服务器接受

技术细节

在Go语言实现中，主要涉及以下核心代码结构：

type SupportedMediaTypes struct {
    Image []string `json:"image"`
    Video []string `json:"video"`
}

func GetSupportedExtensions() ([]string, error) {
    // 实现API调用和数据处理逻辑
}

该功能通过标准的HTTP客户端发起请求，使用JSON解码器处理响应，并将结果转换为便于使用的字符串切片格式。

应用场景

这个功能在以下场景中特别有用：

1. 用户尝试上传文件前，客户端可以预先检查文件扩展名是否被支持
2. 批量上传时，可以过滤掉不支持的媒体文件，避免上传失败
3. 用户界面中可以明确显示支持的媒体类型，提高透明度

总结

Immich-Go通过实现从服务器动态获取支持的媒体类型扩展列表，展示了现代客户端软件开发的一个重要原则：尽可能减少硬编码，增加系统的动态适应能力。这种设计不仅提高了软件的健壮性，也为未来的功能扩展奠定了基础。对于开发者而言，这种模式值得在其他类似项目中借鉴和应用。