Membangun REST API Bersih dengan Laravel

REST API adalah tulang punggung hampir semua aplikasi modern. Di tulisan ini saya rangkum cara membuat API yang rapi dan konsisten di Laravel berdasarkan pengalaman saya membangun berbagai sistem.

1. Definisikan Route API

Gunakan routes/api.php dan kelompokkan dengan prefix versi agar mudah dikelola ke depannya:

use App\Http\Controllers\Api\PostController;

Route::prefix('v1')->group(function () {
    Route::apiResource('posts', PostController::class);
});

2. Gunakan API Resource untuk Response Konsisten

Daripada mengembalikan model mentah, bungkus dengan API Resource supaya format selalu seragam:

class PostResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            'id'         => $this->id,
            'title'      => $this->title,
            'excerpt'    => str($this->body)->limit(120),
            'created_at' => $this->created_at->toIso8601String(),
        ];
    }
}

3. Controller yang Ramping

public function index()
{
    return PostResource::collection(
        Post::latest()->paginate(10)
    );
}

Penutup

Dengan tiga langkah ini, API kamu sudah punya struktur yang bersih, ter-versioning, dan format response yang konsisten. Tinggal tambahkan validasi (Form Request) dan autentikasi (Sanctum) sesuai kebutuhan.

Tips: dokumentasikan API kamu dengan Postman agar tim frontend mudah berintegrasi.