用于查找平均值的REST界面

Question

假设我想创建一个REST接口来查找数字列表的平均值.假设一次提交一个号码.你会怎么做？

1. 将一个号码发布到http://site.com/api/average
2. 如果这是第一个数字,则返回一个哈希值
3. 将一个号码发布到http://site.com/api/average/hash ....
4. 获取http://site.com/api/average/hash查找平均值
5. 删除http://site.com/api/average/hash,因为我们不再需要它了

这是正确的方法吗？有什么建议？

Answer 1

将数字列表视为资源更有意义.假设每个列表的资源URL是/list/{id}这里{id}是列表的ID的占位符.然后:

1. POST /list创建一个新列表,服务器生成一个列表ID(或'hash')并/list/{id}在响应的Location标题中指定URL .
2. POST /list/{id} 在列表中添加一个数字
3. GET /list/{id}/average 返回平均值
4. DELETE /list/{id} 删除列表.

另一种方法是GET /list/{id}/average将GET /list/{id}列表作为结构化数据返回,例如XML,其中包括平均值作为生成的属性.