RESTful API：一个视图中来自多个端点的数据

Question

我已经开始创建一个 RESTful API（好吧，我已经尽力了，我正在尝试遵循这些模式）并且我偶然发现了一个我不确定如何处理的场景。我将解释当前的结构：

我的应用程序有 4 个控制器：

• 客户
• 付款
• 日志

以客户控制器为例，我定义了以下动作：

• GET /customers：返回客户列表
• POST /customers：创建新客户
• GET /customers/{id}：使用提供的 id 返回客户
• PUT /customers/{id}：使用提供的 id 更新客户
• DELETE /customers/{id}：销毁客户

这是客户控制器的完整代码：

namespace App\Http\Controllers;

use App\Customer;
use Illuminate\Http\Request;

class CustomerController extends Controller
{
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        return Customer::all();
    }

    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        $customer = Customer::create($request->all());
        return response()->json($customer, 201);
    }

    /**
     * Display the specified resource.
     *
     * @param  \App\Customer  $customer
     * @return \Illuminate\Http\Response
     */
    public function show(Customer $customer)
    {
        return $customer;
    }

    /**
     * Update the specified resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \App\Customer  $customer
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, Customer $customer)
    {
        $customer->update($request->all());
        return response()->json($customer, 200);

    }

    /**
     * Remove the specified resource from storage.
     *
     * @param  \App\Customer  $customer
     * @return \Illuminate\Http\Response
     */
    public function destroy(Customer $customer)
    {
        $customer->delete();
        return response()->json(null, 204);
    }
}

其他控制器中的代码非常相似。还需要注意的是：

• 一个客户可以进行多次付款
• 一个客户可以在日志中有多个记录

问题从这里开始：

我需要在前端显示一个包含所有客户数据（姓名、电子邮件、注册日期等）的摘要页面和一个显示付款次数的框和另一个显示日志中条目数的框。

我需要提出 3 个请求吗？ （一个给 /customers/id，另一个给customers/id/payments，另一个给customers/id/logs）

如果我在 customers/id 调用中返回所有与客户相关的数据，我是否违反了 RESTful 约定？

Answer 1

我正在使用 apigility，但我的回答仍然会与您的问题相关。根据 REST 术语（可以在此处找到 https://apigility.org/documentation/intro/first-rest-service#terminology），您正在谈论实体和集合。

/customers/id - entity,
/customers/id/payments - collection,
/customers/id/logs - collection. 

这是 3 个不同的请求。所以，是的，你需要提出 3 个不同的请求。

但是，老实说，如果您不需要对 payments 和 logs 进行分页，则您只能向 /customers/id 发出一个请求，并且在响应中您可以拥有带有数组的字段

{
    "_links": {
        "self": {
            "href": "http://localhost:8080/status/3c10c391-f56c-4d04-a889-bd1bd8f746f0"
        }
    },
    "id": "3c10c391-f56c-4d04-a889-bd1bd8f746f0",
    ...
    _payments: [
        ...
    ],
    _logs: [
        ...
    ],
}

更新（与未来访问者的评论重复）。

另外，您应该注意 DTO。我想这个链接会很有趣https://stackoverflow.com/a/36175349/1581741。

更新2。

目前我会这样对待你的收藏/customers/id/payments：

/payments?user_id=123

其中user_id 是payments 表上的过滤字段。

Answer 2

我认为您的问题是您将 REST API 与数据库混淆了。它们不必遵循相同的结构。如果您需要 REST API，您可以轻松返回 GET /customers/{id} 的整个嵌套 JSON。