JSON REST Api 分页页面越界或集合响应代码为空

Question

寻找一些最佳实践，请...

场景一:GET: /api/v1/widgets/?page=10&per_page=5小部件集合仅包含 10 条记录。所以页面越界了。

场景二:GET: /api/v1/widgets/小部件集合当前为空。

所以在这两种情况下，我都在寻找合适的状态代码和响应。

我的想法:

422 unprocessable entity通常用于验证，但是在这种情况下，我认为这是合适的，因为 page请求越界。特别适用于场景 1

400 bad request因为页面越界:场景一

404 Not found因为资源是空的:场景1&2

204 No Content因为两个集合都返回空数据:场景 1 & 2

200 - with data as empty array因为 url 有效，但内容不存在。场景 1 & 2

这种结构是否有当前的最佳实践？

Answer 1

我建议返回一个空集合和状态代码 200。此外，您应该在响应头中提供超链接，以将客户端指向“正确”页面，例如第一页或最后一个“有效”页面。对于集合资源的分页，服务器应始终响应上一页和下一页的超链接。