json - 构建 API：JSON 数组也适用于单元素数组？

Question

我正在构建一个使用 JSON 进行请求/响应的 API。我还希望能够接收批量请求，即 JSON 数组。

现在，如果 JSON 请求总是包装在一个数组中，我有一个可以正常工作的解决方案：

[
{"id":"AAAEEF", "value":"abc"}
]

作品，也

[
{"id":"AAAEEF", "value":"abc"},
{"id":"AAAEF1", "value":"vbc"},
]

如果一个人只想请求一个 id-value 组合并因此请求

{"id":"AAAEEF", "value":"abc"}

请求失败。

我的问题：“好的”API 是否可以强制将所有 JSON 请求包装在一个数组中，即使它们只有一个元素？

提前感谢您帮助我！

Answer 1

编写“好的”API 的关键是保持一致，并做好记录。无论您接下来做出什么选择，都由您自己决定——如果您决定有充分的理由要求对 API 的所有调用都应包装在 thisIsAContainerObject 元素中，请务必记录并释放它。

为了保持一致性，总是需要一个数组甚至可能会更好。只要在插入多个元素时抛出适当的错误。