Cara Membuat REST API di Next.js App Router Tanpa Backend

Kadang kamu ingin membangun API tapi enggan melakukan setup server backend terpisah terlebih dahulu. Pilihan paling efisien saat menggunakan Next.js adalah memanfaatkan fitur Route Handler. Pola ini sangat bisa diandalkan untuk berbagai skala proyek karena alur kerjanya cepat dan mudah dikelola.

Bayangkan Route Handler seperti loket layanan tambahan di dalam gedung yang sama dengan antarmuka web kamu. Frontend dan API tetap dipisahkan secara logika kode. Namun, keduanya tetap berada di dalam satu repositori yang sama sehingga proses pengembangan menjadi lebih ringkas. Jika kamu baru memulai, ada baiknya membaca panduan cara membuat website dengan Next.js untuk pemula terlebih dahulu.

Untuk memulainya, kamu hanya perlu membuat file bernama route.ts di dalam folder app/api. Struktur dasar ini akan otomatis dikenali sebagai endpoint oleh Next.js. Berikut adalah contoh pembuatan endpoint sederhana untuk menangani metode GET dan POST.

import { NextResponse } from 'next/server'

export async function GET() {
  return NextResponse.json({ ok: true, message: 'API siap digunakan' })
}

export async function POST(request: Request) {
  const payload = await request.json()
  // Lakukan validasi payload di sini sebelum masuk database
  return NextResponse.json({ ok: true, payload }, { status: 201 })
}

Langkah pembuatan fungsi GET dan POST di atas sangat penting karena menentukan bagaimana server merespons permintaan klien. Penggunaan NextResponse memastikan respons dikembalikan dalam format JSON yang standar. Pada metode POST, kamu wajib mengurai data permintaan menggunakan agar muatan data bisa divalidasi dan diproses lebih lanjut.