私有REST端点是否应该在错误消息中显示参数名称

Question

我的问题是关于参数名称是否在错误消息中公开。

例如，假设公共端点是https://foo.bar.com/api/results?first=abcd。它的代码应该检查用户指定的参数名称是否正确，如果拼写错误，应该生成一个错误通知用户。

问题：

1. 错误消息是否应该包含参数的名称(第一个(
2. 如果端点是私有的呢？错误消息是否应该包含参数的名称
3. 简而言之，私有端点是否应该公开参数名称

Answer 1

REST和HTTP都不关心。REST说我们应该使用统一的接口和标准化的消息。HTTP定义了标准化响应，并表示具有客户端错误语义的响应应包括

一种表示法，包含对错误情况的解释，以及它是暂时的还是永久的。

由您决定对错误情况的解释是有用的，以及在HTTP响应中应该如何表示。