Next.js, API route özelliği ile backend işlemlerinizi doğrudan frontend projenizin içinde yapmanızı sağlar. Bu sayede ayrı bir backend sunucusu kurmaya gerek kalmaz.

API Route Nedir?

API route, Next.js projesinde pages/api klasörü altında oluşturduğunuz ve HTTP isteklerine cevap veren fonksiyonlardır. Örneğin, pages/api/hello.js dosyasındaki fonksiyon /api/hello endpoint'ine istek geldiğinde tetiklenir.

Basit API Route Örneği

Şimdi adım adım basit bir API route yazalım. Bu route bir JSON verisi döndürecek:

export default function handler(req, res) {
  res.status(200).json({ message: 'Merhaba Next.js API' })
}

Bu kodu pages/api/merhaba.js olarak kaydedin. Çalıştırdığınızda /api/merhaba adresinden JSON yanıtı alırsınız.

HTTP Yöntemlerine Göre Farklı İşlemler

API route içinde req.method ile HTTP metodunu kontrol ederek farklı işlemler yapabilirsiniz:

export default function handler(req, res) {
  if(req.method === 'GET') {
    res.status(200).json({ message: 'GET isteği alındı' })
  } else if(req.method === 'POST') {
    // İstek gövdesini alma
    const data = req.body
    res.status(200).json({ message: 'POST isteği alındı', data })
  } else {
    res.setHeader('Allow', ['GET', 'POST'])
    res.status(405).end(`Method ${req.method} Not Allowed`)
  }
}

İstek Gövdesini (Body) Kullanma

Next.js API route, otomatik olarak JSON gövdesini parse eder. Bu sebeple req.body ile post edilen JSON verisine ulaşabilirsiniz.

Özet

• API route Next.js'de backend fonksiyonlarıdır.
• pages/api klasöründe oluşturulur.
• İstekten req ve res nesneleri ile işlem yapılır.
• HTTP metodlarına göre farklı yanıtlar döndürülebilir.

Bu yapı Next.js ile tam donanımlı uygulamalar geliştirmek için idealdir. Artık kendi API endpoint’lerinizi kolayca oluşturabilirsiniz.