在Laravel 5.2中设计一个RESTful API，使用一个概念上可以包含其他资源的资源。

首先，我对REST实践并不太熟悉，对于我的问题标题也不是很自信。

因此，我正在尝试使用Laravel构建一个RESTful API，用于电话簿应用程序。电话簿可能包含员工（即真实人员）或办公室的电话。因此，我有三个模型：

• 一个带有id和name字段的Directorate（主管）
• 一个带有id和name字段的Employee（员工）
• 一个带有id、tel、employee_id、directorate_id、description和type字段的Telephone（电话）

与主管办公室对应的电话只设置了id、tel、directorate_id和description字段，而与个人（即员工）对应的电话只设置了id、tel、employee_id、directorate_id和type字段。这是我如何区分它们的方式：具有描述的电话只能是办公室的电话，而同时设置了employee_id和type_id的电话是员工的电话。

这些模型的关系如下：

• 一个员工可以有多个电话
• 一个主管可以有多个电话

  class Directorate extends Model
  {
      public function telephones()
      {
          return $this->hasMany(Telephone::class);
      }
      public function employees()
      {
          return $this->hasMany(Employee::class);
      }
  }
  class Employee extends Model
  {
      public function telephones()
      {
          return $this->hasMany(Telephone::class);
      }
      public function directorate()
      {
          return $this->belongTo(Directorate::class);
      }
  }
  class Telephone extends Model
  {
      public function employee()
      {
          return $this->belongsTo(Employee::class);
      }
  }
  

我的问题是我应该将什么视为我的资源。

到目前为止，我考虑以下方法：

我将使用联系人（contact）的概念作为资源。一个联系人（contact）可以是员工和电话的联合信息，也可以是主管和电话的联合信息。例如，一个“联系人”可能包含员工的姓名及其相关的电话号码和电话类型，或者它可以包含主管的名称与电话的描述和电话号码。

这种方法的“问题”在于我最终得到了（可以这么说）两种不同类型的资源：员工的联系人和主管办公室的联系人，它们包含略有不同的信息，因此，我还需要有不同的创建和编辑表单来与这两种“类型”的资源交互。

为了实现REST API，我考虑了两种不同的情况：

1. 使用两个不同的RESTful控制器，一个是EmployeeContacts，另一个是OfficesContacts，将资源在概念上分为员工和办公室的资源，并通过不同的URI访问它们，例如：

   example.com/phonebook/employees/{id}/edit

   example.com/phonebook/offices/{id}/edit

   example.com/phonebook/employees/create

   等等...

2. 使用一个单独的RESTful控制器，例如PhonebookContacts，通过相同的URI访问资源（即现在将员工和办公室的联系人资源都视为只是一个“联系人”资源）

   //这是指一个既可以是办公室的联系人，也可以是员工的联系人的联系人资源

   example.com/phonebook/contact/{id}/edit

   //这应该列出所有资源（包括员工和办公室的联系人）

   example.com/phonebook/contact/

   然后在控制器的create/store/edit/update方法中使用条件语句来分别处理它们（例如，如果一个http POST请求包含description_id，则是办公室的联系人，执行某些操作；否则，如果有employee_id，则是员工的联系人，执行其他操作...）

我想听听你的意见，在我的电话簿应用程序的REST上下文中，你认为这两种不同的情况哪种更好？是否最好考虑一个单一的“联系人”资源，并使用控制器中的条件语句来处理它们并返回不同的结果，还是应该将“联系人”的概念分为“员工的联系人”和“办公室的联系人”，并使用不同的控制器和URI来处理它们？

是否有其他方法我可以跟随？