rest - 如何在 RESTful POST 中返回生成的 ID？

Question

假设我们有一个添加新酒店的服务:

> POST /hotel
> <hotel>
>   <a>aaa</a>
>   <b>aaa</b>
>   <c>aaa.......this is 300K</c>
> </hotel>

然后我们有一个 get:

> GET /hotel

< HTTP/1.1 200 OK
< <hotel>
<   <a>aaa</a>
<   <b>aaa</b>
>   <c>aaa.......this is 300K</c>
< </hotel>

问题是我们为初始 POST 创建返回什么？我们想返回 ID(在服务器上生成)以作为对新资源的“引用”，但我们不想返回所有酒店数据，因为在我们的例子中，其中一个数据字段是一个 ~300K 的平面文件.

所以你应该返回:

< HTTP/1.1 200 OK
< <hotel>
<   <id>123</id>
< </hotel>

或者你应该返回完整的对象:

< HTTP/1.1 200 OK
< <hotel>
<   <id>123</id>
<   <a>aaa</a>
<   <b>aaa</b>
>   <c>aaa.......this is 300K</c>
< </hotel>

??

我对 Restful 最佳实践感兴趣。

注:此相关 post更多地谈论返回什么，而不是谈论如何返回它。

Answer 1

返回状态代码 201 - Created，并将 URL 放在 Location 标题中。你根本不需要返回一个 body 。