Menerapkan REST API Menggunakan Laravel 8 dan Sanctum

Dalam pengembangan aplikasi modern, REST API menjadi fondasi penting untuk menghubungkan frontend dan backend. Laravel 8 menawarkan ekosistem kuat untuk membangun API yang aman, fleksibel, dan mudah diimplementasikan. Salah satu fitur andalannya adalah Laravel Sanctum, sebuah paket otentikasi ringan yang sangat cocok untuk SPA (Single Page Application) dan mobile app 🔐.

Sanctum memberikan cara sederhana dalam membuat token otentikasi tanpa kompleksitas seperti OAuth. Dengan integrasi mudah, developer dapat mengamankan endpoint API, mengatur hak akses, serta memastikan komunikasi antar sistem berlangsung aman dan efisien.

Pada artikel ini, kita akan membahas langkah demi langkah cara membangun REST API di Laravel 8 menggunakan Sanctum, lengkap dengan konfigurasi, contoh kode, hingga praktik terbaiknya 💡.

1. Apa Itu REST API?

Konsep Dasar REST API

REST API (Representational State Transfer Application Programming Interface) adalah arsitektur komunikasi antar aplikasi menggunakan protokol HTTP. API ini bekerja dengan metode seperti GET, POST, PUT, dan DELETE untuk memanipulasi data.

Laravel menyediakan fitur bawaan untuk membuat REST API dengan cara yang mudah dan terorganisir. Developer hanya perlu membuat rute, controller, dan response JSON 📡.

2. Mengapa Menggunakan Laravel 8 untuk REST API?

Keunggulan Laravel 8

Laravel dikenal karena strukturnya yang rapi dan dukungan lengkap untuk pengembangan API. Beberapa alasan mengapa Laravel cocok untuk REST API antara lain:

🧠 Dukungan built-in untuk JSON response
🔒 Integrasi mudah dengan paket keamanan seperti Sanctum
⚙️ Middleware yang fleksibel
🚀 Artisan command mempermudah pembuatan controller dan model
🧩 Struktur MVC yang memisahkan logika dan tampilan

3. Pengenalan Laravel Sanctum

Fungsi dan Kelebihan

Laravel Sanctum adalah paket otentikasi yang dirancang untuk SPA dan API sederhana. Sanctum menyediakan token berbasis personal access token dan sistem autentikasi session-based untuk aplikasi berbasis web.

Kelebihan Sanctum dibandingkan sistem lain seperti Passport:

💡 Implementasi mudah tanpa konfigurasi kompleks
🔐 Mendukung token-based authentication
📱 Cocok untuk mobile app dan SPA
⚡ Performa ringan karena tidak menggunakan OAuth

4. Instalasi dan Konfigurasi Laravel Sanctum

Langkah Instalasi

Langkah pertama adalah menginstal Sanctum melalui Composer:

composer require laravel/sanctum

Kemudian jalankan perintah migrasi:

php artisan migrate

Terakhir, daftarkan middleware Sanctum di file app/Http/Kernel.php bagian API:

'api' => [
    \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
    'throttle:api',
    \Illuminate\Routing\Middleware\SubstituteBindings::class,
],

5. Membuat Model dan Migration

Contoh: Model User dan Post

Laravel sudah memiliki model User bawaan. Kita akan menambahkan model baru untuk data Post:

php artisan make:model Post -m

Isi file migration dengan struktur tabel berikut:

Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->text('content');
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->timestamps();
});

6. Membuat Controller untuk API

PostController

Gunakan command berikut:

php artisan make:controller API/PostController --api

Isi PostController dengan contoh fungsi berikut:

public function index() {
    return response()->json(Post::all());
}

public function store(Request $request) {
    $post = Post::create([
        'title' => $request->title,
        'content' => $request->content,
        'user_id' => auth()->id(),
    ]);
    return response()->json($post);
}

7. Mengatur Routing API

File routes/api.php

Buka file routes/api.php dan tambahkan route berikut:

Route::middleware('auth:sanctum')->group(function () {
    Route::get('/posts', [PostController::class, 'index']);
    Route::post('/posts', [PostController::class, 'store']);
});

Dengan demikian, hanya pengguna yang telah terautentikasi yang dapat mengakses endpoint tersebut 🔑.

8. Autentikasi Pengguna dengan Token

Login dan Register

Buat AuthController untuk menangani registrasi dan login:

php artisan make:controller API/AuthController

Tambahkan kode berikut:

public function register(Request $request) {
    $user = User::create([
        'name' => $request->name,
        'email' => $request->email,
        'password' => bcrypt($request->password),
    ]);
    return response()->json(['token' => $user->createToken('token')->plainTextToken]);
}

9. Logout dan Revoke Token

Menghapus Token

Untuk logout, cukup hapus token aktif pengguna:

public function logout(Request $request) {
    $request->user()->tokens()->delete();
    return response()->json(['message' => 'Logged out']);
}

Dengan pendekatan ini, keamanan data tetap terjaga ✅.

10. Testing API Menggunakan Postman

Cara Uji Endpoint

Buka Postman, lalu buat request:

POST: /api/register → membuat akun
POST: /api/login → mendapatkan token
GET: /api/posts → menampilkan data

Gunakan token hasil login pada header: Authorization: Bearer <token> 🚀.

11. Middleware dan Proteksi Endpoint

Mencegah Akses Tanpa Token

Gunakan middleware auth:sanctum agar hanya pengguna terverifikasi yang dapat mengakses resource API. Laravel akan otomatis memverifikasi validitas token 🔐.

12. Tabel Perbandingan Laravel Sanctum dan Passport

Perbedaan Utama

Fitur	Sanctum	Passport
Kompleksitas	Ringan	Tinggi
Otentikasi	Token sederhana	OAuth2
Cocok untuk	SPA & Mobile App	Enterprise API
Performa	Cepat ⚡	Lebih lambat ⚙️

13. Tips dan Best Practice

Optimasi REST API Laravel

🔄 Gunakan caching untuk mempercepat respons
🧱 Gunakan resource route untuk efisiensi
🧩 Implementasikan validasi di controller
🔐 Lindungi endpoint dengan middleware
📊 Gunakan resource transformer untuk format data yang konsisten

14. FAQ (Pertanyaan Umum)

Apakah Sanctum bisa digunakan untuk mobile app? Ya, Sanctum sangat cocok untuk mobile dan SPA.
Perbedaan utama Sanctum dan Passport? Sanctum lebih ringan dan tidak memerlukan OAuth.
Apakah Sanctum mendukung multi-token? Ya, pengguna dapat memiliki beberapa token aktif.
Bagaimana cara revoke token tertentu? Gunakan $user->tokens()->where('id', $id)->delete();
Apakah bisa digunakan bersama Vue atau React? Bisa, sangat cocok untuk SPA modern.
Apakah Sanctum bisa dihosting di shared hosting? Bisa, karena tidak butuh konfigurasi server khusus.
Bagaimana mengatur masa berlaku token? Bisa disesuaikan di konfigurasi Sanctum.
Bisa digunakan tanpa Laravel Breeze? Ya, Sanctum bisa berdiri sendiri.
Apakah Sanctum aman untuk production? Ya, selama digunakan dengan HTTPS.
Bisa digabung dengan JWT? Tidak disarankan karena redundan.
Apakah Sanctum mendukung logout global? Ya, hapus semua token pengguna.
Bagaimana debugging Sanctum? Gunakan php artisan route:list dan dd($request->user()).
Bisa integrasi dengan Laravel Echo? Bisa untuk real-time app.

15. Kesimpulan

Laravel 8 dan Sanctum merupakan kombinasi ideal untuk membangun REST API modern yang aman dan efisien. Dengan konfigurasi sederhana, developer dapat membuat sistem autentikasi berbasis token yang ringan dan fleksibel 🔥.

Sanctum cocok untuk berbagai kebutuhan — mulai dari aplikasi mobile, SPA, hingga proyek internal perusahaan. Selain mudah digunakan, Sanctum juga mendukung skalabilitas tinggi dan dapat diintegrasikan dengan berbagai framework frontend modern seperti Vue.js dan React 🚀.

Dengan memahami konsep routing, middleware, controller, dan token management, kamu kini siap membangun API profesional berbasis Laravel 8 yang cepat, aman, dan andal 💪.