我正在尝试构建一个 RESTful 服务,但我遇到了一些问题。我将通过一个虚构的 RESTful 服务的示例来描述这些问题(问题)。
例如,我需要在我的网站上提供“新闻”服务。新闻可以有不同的类型:本地新闻和全球新闻。新闻由管理员添加。用户可以查看本地和全球新闻(单独或全部)。新闻按页面显示。用户可以查看确切的新闻。
因此,我为此任务构建了这样一个动词-名词表:
GET /news - Get all news
POST /news - Create news
GET /news/{id} - Show the news with id={id}
PUT /news/{id} - Edit the news with id={id}
GET /news/{type}/{page}/{per_page} - Get news page #{page} of type {type}
GET /news/{page} - Get news page #{page} of both types
所以,有问题:
1)如何区分{page}和{id}?也许 {id} 只能是数字,但 {page} - 一个字符串,以 'p' 开头(例如 'p1'}?
2)用户可以更改值“per_page” - 页面上显示多少条新闻。是不是太复杂了—— /news/{type}/{page}/{per_page}
?如何简化?
3) 浏览器中的 URL 在此服务上应该是怎样的?URL 不会与上表中的 URI 完全相同?例如:
/news - Viewing news (1st page with default 'per_page' and default 'type')
/news/{type} - Viewing news (1st page with default 'per_page' and type={type})
/news/{id} - Viewing exact news with id={id}
/news/{type}/{page}/{per_page} - Viewing exact page of news of exact type.
4) 附加功能。例如过滤搜索(按日期、作者或标题获取新闻)。如何使用 REST 实现这一点?应该如何传输过滤器对象(xml 或 json)?如何使用过滤器的结果制作页面的 URL?/news/{date:12.12.2012,author:'admin'}
还是更好的东西?
对不起,我的英语粗糙,如果您发现一些语法和其他错误 - 请随时纠正它们。
提前致谢。