REST JSON设计
提问于 2013-09-24 23:39:11
对于订单管理应用程序，我需要设计使用JSON的RESTful API。
我希望我的API是这样的，因此请求/响应包含JSON：
订单搜索API
API: /orders/search
{
custname: "john",
orderdate: "10-jun-2013"
}
Response:
{
orders:[
{
orderid:234234,
orderstatus: NEW,
customer: "john"
}
]
}订单更新API
API: /orders/343455
Request Body:
{
orderstatus: "DELIVERED",
recepient: "joe"
}
Response:
{
status: ERROR,
message: "Order does not exist"
}问题
- 如何在GET请求中发送JSON (按顺序搜索API)。
- 我甚至想让每个请求都成为一个POST请求，在正文中包含JSON请求，这说明了操作是什么--但是这是否仍然是REST (可能是'RESTful Web‘或'REST类似于服务’)？
- 我认为在大多数请求中发送JSON是很重要的，这样我的API实现就不会经历太多的变化，因为我在JSON消息中添加了删除的attribs。
- 是否有其他人这样做的例子，特别是返回错误消息。
有什么想法吗？
回答 1
Stack Overflow用户
发布于 2013-09-25 02:36:46
- 如何在GET请求中发送JSON (按顺序搜索API)。
据我所知，HTTP 1.1并没有明确禁止GET方法的请求体。
然而，是否建议这样做的意见是不同的。
但是，GET请求应该(必须)是幂等 --特别是在REST上下文中，并且为了允许缓存。
在SO HTTP与请求体和其他许多问题上也可以看到这个问题。
如果由于任何原因不能在GET方法中指定请求体，则需要在URL查询中包含参数--适当编码(这很痛苦)。
- 我甚至想让每一个请求都成为一个邮政请求。
我是不会做那种事儿的。Web服务框架期望使用相应的HTTP方法执行某些类型的请求。这不利于REST，例如，实际上是GET的POST请求不会被缓存。这也不利于HTTP。
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接：
https://stackoverflow.com/questions/18998982
复制
腾讯云开发者
