最佳实践 - API成功响应消息

时间:2018-03-09 02:40:28

标签: rest api

我当前的项目API使用此响应成功:

  1. 如果它是创建的 - >它将发送创建的对象(201)

  2. 如果是更新 - >它将发送更新的对象(200)

  3. 如果删除 - >它将发送204响应

  4. 示例http://jsonapi.org/的大部分建议都没有说过向用户显示成功的消息。我遵循他们的规则继续回归对象或204成功

    如果我想向用户显示“成功创建”或“成功更新”,该怎么办?消息应该直接来自服务器端还是客户端(键入它或使用某些语言环境)?

1 个答案:

答案 0 :(得分:1)

您应该查看RFC 7231及其对200 OK

的描述
  

200响应中发送的有效负载取决于请求方法。对于本规范定义的方法,有效载荷的预期含义可以概括为:

     

POST表示行动的状态或结果;   PUT,DELETE表示行动的状态;

所以是的,使用响应主体向用户呈现警报的表示罚款

对于201 Created,适用相同的基本规则

  

201响应有效负载通常描述并链接到创建的资源。

204 No Content并不相似,原因很简单," No Content"指消息体; 204是您可以向客户端(和中间组件)指示0字节有效负载不是错误的方法之一。

  

204响应允许服务器指示该操作已成功应用于目标资源,同时暗示用户代理不需要遍历其当前的文档视图" (如果有的话)。服务器假定用户代理将根据其自己的界面向其用户提供成功的一些指示,并在响应中将任何新的或更新的元数据应用于其活动表示。