休息端点成功并提供有用的警告

Question

我收到客户的请求 - 当用户执行操作时，可以有3个操作：

• 操作成功，状态为200 OK
• 操作失败（400），并显示错误消息
• 操作成功但我们需要向用户显示有用的警告消息。当分配的金额几乎用完时会发生这种情况。

似乎没有办法让REST API通过一些有用的信息返回操作已成功完成的指示，表明进一步的操作可能会失败。

由于

Answer 1

HTTP响应代码是有限的，我认为，那些用于表示任何通用响应。要获得特定于应用程序的响应代码或响应字符串，最好通过HTTP响应有效负载传送应用程序级响应代码。

Answer 2

您没有提到您正在准备的HTTP方法。使用GET当然不应修改任何内容，因此我假设它是POST或PUT。

对于POST，响应应为 201 Created 。应该有一个Location标题行，表示创建的资源。

对于PUT，响应应 200 OK 。

在这两种情况下，您都可以像其他人建议的那样返回内容正文。此正文可以是有关您正在使用的任何资源的当前状态的一些状态信息。请注意，此状态信息可能由某个其他URI显式访问，因此它可以与该“status”资源共享mime-type。

Answer 3

REST正在使用HTTP方法和HTTP状态来表示回复状态，通过检查HTTP状态我可以找到代码203我认为它可能适合您的第三种情况：

  

203非权威信息（自HTTP / 1.1起）       服务器成功处理了请求，但返回的信息可能来自其他来源。