40、API 数据导入导出与版本兼容性全解析

API 数据导入导出与版本兼容性全解析

1. API 数据导入导出

1.1 过滤功能在导入导出中的应用

在 API 操作中，对资源集合进行过滤是一项非常有价值的功能，它能让我们更高效地与存储在 API 中的数据进行交互。不过，这种资源过滤的理念在自定义导入和导出方法中的应用，与标准列表方法既有相同之处，也存在差异。

1.1.1 导出数据过滤

导出数据的目标是提供一种将存储系统直接连接到 API 的方式，这与标准列表方法本质上并无不同。因此，自定义导出方法理应支持在导出前对项目进行过滤。在 API 定义中，只需在导出请求接口中添加一个过滤字段即可实现，示例代码如下：

interface ExportMessagesRequest {
  parent: string;
  outputConfig: MessageOutputConfig;
  dataDestination: DataDestination;
  filter: string;      
}

这里的过滤字段放在 OutputConfig 接口旁边，而非其内部，是因为输出配置专注于将资源转换为字节的方式，而过滤则是在这一阶段之前进行的，主要用于选择哪些资源将被序列化、压缩等。将这两个功能分开，能确保每个部分只负责一项任务，符合关注点分离的原则。

1.1.2 导入数据过滤

与导出数据时对 API 选择的数据应用过滤不同，导入数据时进行过滤更为复杂。它需要先将字节从外部存储系统传输到 API