>[info] 響應 一個可用的 API 簡單來說就是通過接受請求并將易處理的響應返回給客戶端，一般來說， API 有多種易處理的方式返回響應，例如 JSON ，而具體應該使用哪種方式返回響應取決于你的 API 的復雜程度。 ***** 通常來說，直接在控制器中返回一個數組或對象就是最簡單的返回響應的方式，但是不是所有的對象都能被正確的格式化，所以需要確認該對象實現了 `ArrayObject` 或 `Illuminate\Support\Contracts\ArrayableInterface` 接口。 ~~~ class UserController extends Controller { public function show() { return User::all(); } } ~~~ 這個包將會自動的格式化響應為 JSON，并設置 `Content-Type` 頭為 `application/json`。 ***** >[info] 響應生成器 響應生成器提供了一個流暢的接口去方便的建立一個更定制化的響應。響應的生成器通常是與 **transformer** 相結合。 ***** 要利用響應生成器，你的控制器需要使用 `Dingo\Api\Routing\Helpers` trait。為了在你的控制器里保持引入和使用這個 trait，你可以創建一個基礎控制器，然后你的所有的 API 控制器都繼承它。 ``` use Dingo\Api\Routing\Helpers; use Illuminate\Routing\Controller; class BaseController extends Controller { use Helpers; } ``` ***** >[info] 響應一個數組 ~~~ <?php namespace App\Http\Controllers; use Dingo\Api\Routing\Helpers; use App\User; class UserController extends Controller { use Helpers; public function show($id) { $user = User::findOrFail($id); return $this->response->array($user->toArray()); } } ~~~  ***** >[info] 響應一個元素 **控制器：** ~~~ <?php namespace App\Http\Controllers; use Dingo\Api\Routing\Helpers; use App\User; use App\Http\Controllers\Api\TestapiTransformer; class UserController extends Controller { use Helpers; public function show($id) { $user = User::findOrFail($id); return $this->response->item($user , new TestapiTransformer()); } } ~~~ ~~~ <?php namespace App\Http\Controllers\Api; use App\User; use League\Fractal\TransformerAbstract; class TestapiTransformer extends TransformerAbstract { public function transform(User $user) { return [ 'id' => $user['id'], 'name' => $user['name'], 'email' => $user['email'], ]; } } ~~~ **結果：**  ***** >[info] 響應一個元素集合 ~~~ <?php namespace App\Http\Controllers; use Dingo\Api\Routing\Helpers; use App\User; use App\Http\Controllers\Api\TestapiTransformer; class UserController extends Controller { use Helpers; public function show($id) { $user = User::all(); return $this->response->collection($user , new TestapiTransformer()); } } ~~~ **結果：**  ***** >[info] 分頁響應 **控制器：** ~~~ <?php namespace App\Http\Controllers; use Dingo\Api\Routing\Helpers; use App\User; use App\Http\Controllers\Api\TestapiTransformer; class UserController extends Controller { use Helpers; public function show($id) { $user = User::paginate(2); return $this->response->paginator($user , new TestapiTransformer()); } } ~~~ **結果：**  >[info] 無內容響應 瀏覽器刷新無任何響應 ``` return $this->response->noContent(); ``` >[info] 錯誤響應 ~~~ // 一個自定義消息和狀態碼的普通錯誤。 return $this->response->error('This is an error.', 404); ~~~  ***** ~~~ // 一個沒有找到資源的錯誤，第一個參數可以傳遞自定義消息。 return $this->response->errorNotFound(); ~~~  ***** ~~~ // 一個 bad request 錯誤，第一個參數可以傳遞自定義消息。 return $this->response->errorBadRequest(); ~~~  ***** ~~~ // 一個服務器拒絕錯誤，第一個參數可以傳遞自定義消息。 return $this->response->errorForbidden(); ~~~  ***** ~~~ // 一個內部錯誤，第一個參數可以傳遞自定義消息。 return $this->response->errorInternal(); ~~~  ***** ~~~ // 一個未認證錯誤，第一個參數可以傳遞自定義消息。 return $this->response->errorUnauthorized(); ~~~  ***** >[info] 添加額外的頭信息 ~~~ $user = User::findOrFail($id); return $this->response->item($user, new TestapiTransformer())->withHeader('X-Foo', 'Bar'); ~~~ >[info] 添加 Meta 信息 添加 meta 數據： ~~~ return $this->response->item($user, new TestapiTransformer())->addMeta('foo', 'bar'); ~~~  自定義設置多個數據： ~~~ return $this->response->item($user, new TestapiTransformer())->setMeta(["id" => 1,'name' => 'wqs']); ~~~  ***** >[info] 設置響應狀態碼 ~~~ return $this->response->item($user, new TestapiTransformer())->setStatusCode(200); ~~~