假设我想创建一个REST接口来查找数字列表的平均值.假设一次提交一个号码.你会怎么做?
将一个号码发布到http://site.com/api/average
如果这是第一个数字,则返回一个哈希值
将一个号码发布到http://site.com/api/average/hash ....
获取http://site.com/api/average/hash查找平均值
删除http://site.com/api/average/hash,因为我们不再需要它了
这是正确的方法吗?有什么建议?
将数字列表视为资源更有意义.假设每个列表的资源URL是/list/{id}
这里{id}
是列表的ID的占位符.然后:
POST /list
创建一个新列表,服务器生成一个列表ID(或'hash')并/list/{id}
在响应的Location
标题中指定URL .
POST /list/{id}
在列表中添加一个数字
GET /list/{id}/average
返回平均值
DELETE /list/{id}
删除列表.
另一种方法是GET /list/{id}/average
将GET /list/{id}
列表作为结构化数据返回,例如XML,其中包括平均值作为生成的属性.