RESTful API POST/DELETE应该在正文中返回什么？

Question

要通过RESTful API关注和取消关注一个人,我有

• POST/person/bob/follow
• DELETE/person/bob/follow

它们应该在体内返回什么？

1. 您关注的每个人的集合
2. 你刚跟随/不跟进的人
3. 状态如{status:"ok"}
4. 没有.

Answer 1

如果使用HTTP服务器状态响应错误,则状态代码不会说任何内容.如果在没有用户Bob的情况下回复404 Not Found,或者如果数据库损坏则回复500 Internal Server Error,那么您将获得的唯一成功响应就是OK.用户不必检查状态代码,只需检查HTTP状态代码即可.

我建议你什么都不返回,事实上它是一个成功的响应(即200 OK或204 No Content)表明操作成功.

Answer 2

这完全取决于您的app/API设计以及您将与客户/呼叫者定义的合同.但通常情况下,在所有情况下,您都应返回状态代码,以使您的客户端了解结果.

喜欢:respond(ResponseCode::OK, ...)

For POST:我会返回'​​bob'对象,其中包含所有关注者+状态代码
For DELETE:我只返回状态代码.