RESTful 的增删改查成功应该返回什么状态码?

[Vimax]

RESTful 的 GET POST PUT DELETE 如果操作成功应该返回什么状态码呢?

用 200,201,202,204 代表 4 种请求的成功合适吗?

请求成功

• GET 200 OK
• POST 201 Created
• PUT 202 Accepted
• DELETE 204 No Content

如果 GET POST PUT 　 DETELE 请求,数据库执行结果都为 0.又如何返回 HTTP 状态码呢?

是返回 404 not found 吗?

另外一个问题

请求方式的数据类型: GET 和 DELETE 是否[不能]或[不推荐]使用 JSON 数据的形式.

前端使用的是 VUE axios 发送请求,之前 DELETE 发送 JSON 数据,后端无法接收到.

目前 4 种请求方式对应使用的数据类型是:

• GET application/x-www-form-urlencoded
• POST [ "application/json;charset=UTF-8" ]
• PUT [ "application/json;charset=UTF-8" ]
• DELETE application/x-www-form-urlencoded

[hantsy]

Spring 内容协商规律：

Get , Accept: application/json
POST,PUT Content-Type:application/json
DELETE 不用管。

实现：
https://github.com/hantsy/spring-reactive-jwt-sample/blob/master/src/main/java/com/example/demo/web/PostController.java

各种情况状态返回参考测试代码：

https://github.com/hantsy/spring-reactive-jwt-sample/blob/master/src/test/java/com/example/demo/IntegrationTests.java

[qdzzyb]

成功统一 200 就可以了

[Vimax]

@hantsy 学习了.谢谢兄弟.

[Vimax]

@qdzzyb 这样语义不清晰吧.

[bxb100]

@Vimax #4 统一返回 200, 然后返回定义的 业务 code 处理错误

[chendy]

get 和 delete 默认没 body，指定 application/x-www-form-urlencoded 没用

[hantsy]

在 Spring 3 。x 的时候都是要自己配置，现在自动内置了 Content Negotiation 内容。

https://spring.io/blog/2013/05/11/content-negotiation-using-spring-mvc/

对于 REST API，内容协商主要就是根据 Accept （返回内容可接受的格式） 和 Content-Type （请求的内容使用格式） 来决定 mediatype 。

一般情况下：

GET, 前端需要设置 Accept: application/json
POST,PUT 前端需要设置 Content-Type:application/json
DELETE 不用管。

如果有特例，特殊要求，比如 POST 有返回内容，那么 Accept，Content-Type，甚至你可以用不同的格式。

Accept:applicaiton/xml
Content-Type:applicaiton/json

这个依赖你后端是否能够处理。

[baiyi]

状态码是根据不同的接口有不同的响应。

GET 200 不必多说。

POST 也有很多种形式，如果是正常创建并需要返回创建结果的，可以使用 201 Created
如果是异步处理，提前响应结果的，需要使用 202 Accepted
如果是正常处理，不需要响应结果的，需要响应 204 No Content
如果是正常处理，但结果不方便直接响应，需要返回 205 Reset Content，提示 Client 重新获取

如果你想写一个非常标准的 HTTP API，那就需要学习每个状态码所代表的含义，不能与请求方法一一对应
如果不想这么费劲，因为确实也没多少人在乎，那就完全可以直接 200，也没问题

[hantsy]

对于 Accept，Content-Type，Spring 的 Controller 方法 @RequestMapping （或者其它 GetMapping，xxx 等） 可以设置 produces，consumes 属性对应处理。

Accept ---------------produces
Content-Type----------consumes

默认情况下，现在 Spring 处理过于宽松，什么格式都放进来。严格的情况下最好指定 Mediatype，对于一些不支持格式，前端访问 API 时，Spring 会更快速的响应，返回 415 。

[jones2000]

你返回数据结构里面应该有一个状态码， 这些查询或操作失败的， 最好是返回 200 ok, 然后内有有一个状态码来表示具体的错误码，好点的还有一个错误的描述字符串， 方便前端提示给客户，否则都是 404，客户直接抓瞎了。

[hantsy]

@jones2000 404 怎么会抓狂？？？

/posts/anoneexistingpost 是一个不存在的 Post
/users/noneexistignuser 是一个不存在的 User
/products/noneexiting 是一个不存在的产品
/orders/noneexiting 是一个不存在的订单

[hantsy]

不同的路径下 404 的意义已经将不同的 Resource 区分的很清楚，只有 SB 才用 200 返回一切数据。

[wangyanrui]

全部 200，自定义 code

另：前面的兄弟们吵起来不要带上我~

[zhuweiyou]

国情是全部 200，你搞各种状态码，前端要骂你的。

[qdzzyb]

@Vimax #4 不会不清晰吧 GET 200 POST 200 PUT 200 DELETE 200 这四个表示的是四个语义吧
一般前端喜欢 统一返回 200 body 里{code: 0, data: xxx} 或者 {code: xxx, err_msg: "error message"}

[EminemW]

不是应该 http 状态码描述请求状态 自定义业务状态码描述业务状态么

[hantsy]

@qdzzyb
@zhuweiyou 你们公司由前端决定系统架构吗？由前端来定交互协议？

[hantsy]

Angular 中 httpclient 处理 API 使用 Rxjs Obseverable, subscribe 中 next 和 error 天然分开处理。

用 axios 访问 API 的话，then 里面正常业务，catch 处理异常。

代码清楚可见。

全部返回 200 就会部跑到 then 里面, 代码变成屎一样。哪个前端喜欢写这样的屎？我听到很多前端抱怨过后端写的什么垃圾都塞进 200 body，自己拿到还要先判断。

自己的懒惰，无知和无能非要说成什么国情，前端需要。

[wanacry]

参考 es 的

[xlinux]

400 会不会被打？