REST:获取资源统计信息的URI和方法

时间:2014-11-14 08:00:45

标签: rest restful-url

获取资源统计信息的正确(最佳)方法是什么。例如。我有这样的资源

/tournaments

返回锦标赛列表(让我们说分页):

{
    items: [
        {
            id: 1,
            name: ...,
            created: ...,
            ...
        },
        {
            id: 2,
            name: ...,
            created: ...,
            ...
        },
    ]
}

我想显示一个年份图表,其中的列显示一个月内创建的锦标赛数量。所以我需要这样的东西:

[
    year: 2014,
    month: 1,
    tournaments: 10,
],
[
    year: 2014,
    month: 2,
    tournaments: 8,
],
[
    year: 2014,
    month: 3,
    tournaments: 42,
],
...

这样的内容应该放在哪里?在/tournamets资源或其他地方?在GET请求下? 也许是这样的:

/tournaments/stats?year=2014

应该怎么样? 或者我可以将这些统计信息添加到/tournament节点旁边的每个items响应中吗?

1 个答案:

答案 0 :(得分:1)

你如何GET一场锦标赛?如果你使用

GET /tournaments/1234

其中1234是一场锦标赛的ID,我觉得使用

不是一个好主意
GET /tournaments/stats

获取统计信息。 /tournaments是一个集合资源,stats不是此集合中一个tornament的ID。

所以我使用不同的资源,例如

GET /tournamentsstats

然后可以过滤

/tournamentsstats?year=2014