Rest API替代设计,用于在Web应用程序中使用slu

时间:2016-04-13 20:55:10

标签: rest api-design

我正在创建一个API,但使用SEO友好的slugs而不是ID' s。我最常遇到的网址设计使用复数形式,总是这样:

GET /accounts -> index account
GET /accounts/:id -> show account
GET /accounts/:id/sites/:id -> nested show site

对于只有CRUD操作的纯API,这很好,但如果我这样做:

GET /accounts/new
GET /accounts/whatever

然后匹配上面的帐户。一个可能的解决方案是拒绝产生像" new"和"无论如何",但它似乎是hackish。到目前为止我所做的只是使用单数形式,除非它后面跟着一个slu or或ID:

GET /account/new -> new account form
GET /accounts/:id -> show account

但这可能会引起混淆。混合复数和单数可能不是最佳的,但是我没有找到一个很好的替代方法,它们也支持友好的URL,它也支持嵌套资源,如上面的show site示例。

如果不使用已经提到的两种方案中的任何一种,是否有其他方法可以设计易于理解的URL方案?

0 个答案:

没有答案