Digital Transformation
Route Handler (Next.js)
TL;DR: Route Handler adalah cara Next.js App Router membuat endpoint API di dalam proyek lewat file route.ts, tanpa perlu backend terpisah. Satu file bisa menangani GET, POST, PUT, dan DELETE, lalu mengembalikan JSON atau data lain langsung ke frontend.
Apa itu Route Handler?
Route Handler adalah file route.ts (atau route.js) di folder app/ Next.js yang berfungsi sebagai endpoint API. Anggap saja seperti loket pelayanan di dalam gedung yang sama dengan ruang tamu: pengunjung tidak perlu pergi ke gedung lain untuk mengambil data. Sebelum App Router, fungsi ini dipegang oleh pages/api, dan kini Route Handler menggantikannya dengan dukungan penuh terhadap Web standar Request dan Response.
Route Handler sering dipakai berdampingan dengan middleware Next.js yang menyaring request sebelum sampai ke endpoint. Untuk pemula, bayangkan middleware sebagai satpam di pintu masuk, sedangkan Route Handler adalah petugas loket yang benar-benar memproses permintaan.
Kapan Dipakai?
| Kebutuhan | Cocok pakai Route Handler? |
|---|---|
| Form kontak kirim email | Ya, lewat handler POST |
| Webhook dari payment gateway | Ya, terima notifikasi server-to-server |
| Ambil data publik saat build | Lebih baik fetch langsung di Server Component |
| Proteksi API key pihak ketiga | Ya, key disimpan di server, bukan di browser |
Kenapa Penting?
Bagi marketer yang sitenya dibangun di Next.js, Route Handler berarti fitur seperti form, integrasi CRM, atau tracking event bisa berjalan tanpa biaya server tambahan. Dalam beberapa proyek website bisnis yang saya tangani, memindahkan logika form ke Route Handler memangkas dependensi pada layanan pihak ketiga dan membuat data tetap di bawah kendali sendiri. Ini selaras dengan prinsip menjaga first-party data yang makin penting di era pembatasan cookie.
Pertanyaan Umum
Apa beda Route Handler dan Server Action?
Route Handler membuat endpoint HTTP yang bisa dipanggil dari mana saja, termasuk layanan eksternal. Server Action lebih cocok untuk mutasi data dari dalam aplikasi sendiri tanpa membuat endpoint publik.
Apakah Route Handler memengaruhi SEO?
Tidak langsung, karena ia melayani data, bukan halaman. Namun endpoint yang cepat membantu fitur interaktif terasa responsif, yang berdampak pada pengalaman pengguna.
Istilah Terkait