26、API开发中的数据处理与查询优化

API开发中的数据处理与查询优化

1. 处理410 Gone状态

在API开发中，可能会出现API客户端尝试使用HTTP PUT方法更新一个已被其他API消费者通过HTTP DELETE请求删除的记录的情况。此时，API客户端应收到410 Gone响应，并记录该情况以便后续检查。

数据服务接口在响应中应始终返回实体标签（ETag）。这是API提供者和消费者在进行写请求时确保资源完整性的最佳方式。以数据为中心的服务接口必须拒绝任何不包含实体标签头（创建时使用If - None - Match，更新和删除时使用If - Match）的修改资源状态的尝试（通过PUT、POST、PATCH和DELETE）。

虽然HTTP规范还定义了基于日期时间戳的If - Modified - Since和If - Unmodified - Since头，但建议优先使用基于实体标签的头。

当更新失败且没有简单的机器驱动方法来解决问题时，API消费者应用程序应记录日志或发送文本/电子邮件消息表明失败，并请求人工处理。

2. 隐藏外部操作的数据关系

在遵循从服务接口隐藏数据技术的原则时，隐藏该技术所采用的任何数据模型关系也很重要。

2.1 问题

如何设计一个最佳方案，将数据模型关系（例如一个人对应一个或多个地址记录）从服务接口中隐藏起来？是否有办法在不暴露接口背后的数据模型或数据技术的情况下支持后端关系？

2.2 解决方案

写入包含底层数据模型中实体关系的数据时，最安全的方法是使用关联数据的“扁平视图”来表示数据属性。例如，在人员和地址的案例中，单个写操作应