Day03-CRUD API 实作（三）Route、Postman 测试 API

大家好～
昨天完成会员系统的 Controller，
今天要来完成会员系统的 Route ，
并且用 Postman 测试一下我们会员系统的功能是否正常！

Route

将我们写好的功能加入 routes/api.php 内。

use  App\Http\Controllers\AuthController;

Route::post('/register', [AuthController::class, 'register']);
Route::post('/login', [AuthController::class, 'login']);

// 将需要带 Token 才能使用的 API 放在下面的 Route::group
Route::group(['middleware' => ['auth:sanctum']], function () {
    Route::get('/logout', [AuthController::class, 'logout']);
});

Route 的写法在 Laravel 8 做了次更新，
旧版的写法(如下图)已不再支援。

php artisan route:list

使用该指令可以列出所有的 Route，
在该指令後方加上| grep 关键字，
即可做到搜寻，如下图：

Route 完成後我们就来用 Postman 做测试吧！

使用 Postman 测试 API

Postman 的安装与详细介绍网路上已有许多教学，
文末的参考资料会推荐几篇关於 Postman 的教学文章。

首先在我们专案的资料夹下该指令来启动本地 Server：

php artisan serve

Environments 简介

在 Environments 可以设定环境参数，
像上图我有设定了 url 的环境参数，
之後我有需要在 Postman 用到 http://127.0.0.1:8000 时，
只需要用 {{url}} 就可以调用我所设定的环境参数。

Register 测试

1. 选择我们 API 所使用的 Request methods
2. API 的 Endpoint
3. Request 的 设定
   • Headers 与 Body 填入我们要传给 API 的 Key 与 Value
4. 发送 Request
5. 取得我们 API 的 Response

Login 测试

Logout 测试

测试完毕～
三个功能皆是正常的！

其中登出是必须带 Token 才能使用的功能，
而在 Postman 内要带 Token 的话，
可以在 Authorization 内选择 Type，
我们 Token 的 Type 为 Bearer Token 。

今天差不多就先这样啦，
那麽明天就要开始做留言的 Model 罗。

大家明天见啦～
若文章有任何问题，
还请大家不吝赐教！

参考资料

• Laravel Routing
• Postman 新手教学｜使用Postman 开发出你的第一支 API
• Day17 介绍request发送工具 Postman
• Day29 Postman 设定环境变数