How to Build an API with Laravel Breeze in Laravel 11
A step-by-step guide on building a simple API with authentication using Laravel Breeze in Laravel 11.
Step 1: Install Laravel
First, create a new Laravel project using the Laravel installer or Composer.
# Or via Composer
composer create-project laravel/laravel api-breeze
cd api-breeze
Step 2: Install Laravel Breeze
Next, install Laravel Breeze and its dependencies.
php artisan breeze:install api
This command will install Breeze and set up the necessary scaffolding for API authentication.
Step 3: Configure the Database and Run Migrations
Update your .env file with your database credentials:
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel11_api
DB_USERNAME=root
DB_PASSWORD=
Run the migrations to set up your database tables:
Step 4: Create Authentication Endpoints
Laravel Breeze provides the necessary endpoints for registration, login, and logout. The routes are defined in routes/api.php.
use AppHttpControllersAuthRegisteredUserController;
use IlluminateSupportFacadesRoute;
Route::post(‘/register’, [RegisteredUserController::class, ‘store’]);
Route::post(‘/login’, [AuthenticatedSessionController::class, ‘store’]);
Route::post(‘/logout’, [AuthenticatedSessionController::class, ‘destroy’])->middleware(‘auth:sanctum’);
Step 5: Update Controllers
Modify the RegisteredUserController and AuthenticatedSessionController to return JSON responses.
RegisteredUserController.php
use AppModelsUser;
use IlluminateAuthEventsRegistered;
use IlluminateHttpRequest;
use IlluminateSupportFacadesHash;
use IlluminateValidationRules;
use AppHttpControllersController;
class RegisteredUserController extends Controller
{
public function store(Request $request)
{
$request->validate([
‘name’ => [‘required’, ‘string’, ‘max:255’],
’email’ => [‘required’, ‘string’, ’email’, ‘max:255’, ‘unique:users’],
‘password’ => [‘required’, ‘confirmed’, RulesPassword::defaults()],
]);
$user = User::create([
‘name’ => $request->name,
’email’ => $request->email,
‘password’ => Hash::make($request->password),
]);
event(new Registered($user));
$token = $user->createToken(‘auth_token’)->plainTextToken;
return response()->json([
‘access_token’ => $token,
‘token_type’ => ‘Bearer’,
‘user’ => $user
]);
}
}
AuthenticatedSessionController.php
use IlluminateHttpRequest;
use IlluminateSupportFacadesAuth;
use AppHttpControllersController;
class AuthenticatedSessionController extends Controller
{
public function store(Request $request)
{
$request->validate([
’email’ => [‘required’, ‘string’, ’email’],
‘password’ => [‘required’, ‘string’],
]);
if (!Auth::attempt($request->only(’email’, ‘password’))) {
return response()->json([‘message’ => ‘Invalid login credentials’], 401);
}
$user = Auth::user();
$token = $user->createToken(‘auth_token’)->plainTextToken;
return response()->json([
‘access_token’ => $token,
‘token_type’ => ‘Bearer’,
‘user’ => $user,
‘status’ => ‘Login successful’,
]);
}
public function destroy(Request $request)
{
$request->user()->currentAccessToken()->delete();
return response()->json([‘message’ => ‘Logout successful’]);
}
}
Step 5: Run Laravel App
Step 6: Check following API
Test Your API with Thunder Client