34、API 数据写入与分页处理策略

API 数据写入与分页处理策略

1. 匿名数据写入

1.1 动机

在向 API 写入数据时，传统做法是创建带有唯一标识符和架构的资源。然而，在现实世界中，存在一些场景，数据写入后无需唯一标识，例如日志文件中的条目或用于统计聚合的时间序列数据点。因此，需要一种新的方式来处理这类非资源导向的数据，同时又能与现有的面向资源的设计原则相契合。

1.2 概述

为解决这一问题，引入了一种特殊的自定义方法 write 。它与标准的 create 方法类似，用于向 API 插入新数据，但不同的是，写入的数据条目是匿名的，即没有唯一标识符，并且不能在写入后进行寻址、检索、更新或删除操作。这种数据通常通过聚合方式进行查看，例如请求条目总数或平均值。为了区分，将通过 write 方法插入的数据点称为“条目”（entry）。

1.3 实现

1.3.1 返回类型

标准的 create 方法会返回新创建的资源，而 write 方法没有可返回的资源。它将数据添加到集合中，或用于流式操作以更新计数器或聚合值。因此， write 方法应返回 void ，即不返回任何内容，仅返回操作结果的状态码。

1.3.2 数据传输

标准的 create 方法依赖于一个 resource 字段来接受要创建的资源值。而