处理无效＆＃34;限制＆＃34;的最佳做法在分页API中？

Question

我正构建一个api端点，通过limit参数提供分页。

默认为10，最大值为100。

如果请求包含超出允许范围的limit，我该怎么办？

例如，如果请求limit为105，我应该使用100 limit处理请求，忽略它并使用默认值（10），或者回复错误通知客户的允许范围？

我想知道的其他例子有limit: 0，limit: -1，limit: "garbage"

响应有效负载将指定处理请求时使用的限制。尽管如此，我倾向于回应信息错误，而不是试图推断客户想要什么。那有点矫枉过正吗？

什么是最佳做法？

Answer 1

我认为您应该返回HTTP 400 - 错误请求。如果响应与客户端的表达相匹配，则只应返回有效数据。