在REST中使用'createModel'是否是一种好习惯？

Question

我正在寻找实现REST-full应用程序端点的最佳方法，该端点将负责创建新的图书馆订单。假设我有以下资源。

如果我想获得特定作者的所有书籍，可以使用下一个端点：

HTTP GET
api/books/author/123

如果我想获取特定书籍的所有订单，可以使用下面提供的端点：

HTTP GET
api/books/456/orders

我的问题是，最能创建订单的端点的URL和请求模型是什么？在我看来，它可能是>

HTTP POST
api/books/456/orders
还有一个问题。在REST中使用CreateOrder之类的请求模型是一种好习惯吗？如果我想创建一个REST-full Web应用程序，可以使用以下请求模型：

class CreateOrder 
{
   AuthorId: number;
   BookId: number;
   ClientId: number;
} 
有时让我感到困惑。请求模型应该看起来像我们的资源吗？ 

我正在寻找实现REST-full应用程序端点的最佳方法，该端点将负责创建新的图书馆订单。假设我有以下资源。如果我...

Answer 1

您的端点不必始终以/books开头。您可以引入另一个端点/orders来创建或获取订单。因此，要创建订单，您可以：