API设计 - 用400s响应有用错误消息的最佳方法是什么？

Question

我正在设计一个尽可能符合HTTP标准的API。这包括发回特定的响应代码并使用Accept标头指定版本和响应类型。

我知道这可能看似主观，但我确信这是一种传统的做法。我有一组API支持的响应类型，以及特定于供应商的mime类型来指定类型和版本。

目前，当客户端指定不存在的版本或类型时，我只是返回一个空主体400 Bad Request，但是，我想返回一个有用的错误消息。如果我不知道响应类型，我觉得有点脏回复纯文本（或默认为JSON）。我是否缺少一个标题，或者我应该遵循哪些惯例？我想从偏移中得到这个。

谢谢，我的最好，

杰米

Answer 1

尝试状态代码406 Not Acceptable。

Answer 2

http://support.microsoft.com/kb/943891/

这是Microsoft IIS支持的HTTP子代码列表。我发现这个页面非常方便，因为它可以帮助您深入了解用于处理各种错误的消息。有一些HTTP子代码引用标题。