Node.js ile REST API Nasıl Yazılır? Başlangıçtan İleri Düzeye Adım Adım Rehber

Web dünyasında bir şeyler inşa etmeye başladığınızda, kullanıcılarınızla iletişim kurabilmek için bir API'ye ihtiyaç duyarsınız. Eğer Node.js'i zaten biraz tanıyorsanız, REST API'leri yazmak sizi korkutmasın! Bu yazıda, Node.js ile nasıl sağlam ve hızlı bir REST API oluşturabileceğinizi adım adım öğreneceksiniz.

REST API yazmaya başlamadan önce, Node.js ve Express.js hakkında biraz bilgi sahibi olmanız gerekiyor. Node.js, JavaScript'in sunucu tarafında çalışabilmesi için geliştirilmiş harika bir platformdur. Web uygulamalarının backend tarafını yazmak için yaygın olarak kullanılır.

Express.js ise, Node.js üzerinde çalışan minimal bir framework'tür. Web sunucusu kurmayı ve API geliştirmeyi inanılmaz derecede kolaylaştırır.

Şimdi, Express.js'i nasıl kuracağımıza bakalım:

npm init -y

Yukarıdaki komutlarla, yeni bir Node.js projesi oluşturup Express'i kurduk.

Artık Express'i kurduğumuza göre, API rotamızı yazmaya başlayabiliriz. En basit haliyle, bir HTTP GET isteğine yanıt veren bir API yazalım. Bu, temel işlevsellik için mükemmel bir başlangıç olacaktır.

İlk API rotamızı şöyle yazıyoruz:

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
    res.send('Merhaba Dünya!');
});

app.listen(port, () => {
    console.log(`Sunucu http://localhost:${port} üzerinde çalışıyor`);
});

Burada `GET /` rotası, ana sayfaya gelen istekleri karşılıyor ve "Merhaba Dünya!" mesajını döndürüyor. Sunucumuz çalıştığında, terminalde "Sunucu http://localhost:3000 üzerinde çalışıyor" yazısını görmelisiniz.

Bir REST API, sadece veri almakla kalmaz, aynı zamanda veri göndermeyi de sağlar. Şimdi POST isteği için bir örnek ekleyelim. Bu, kullanıcıdan veri alıp veritabanına kaydetmek için kullanılır.

İlk olarak, `express.json()` middleware'ini kullanarak gelen JSON verisini okuyabiliriz.

app.use(express.json());

app.post('/kullanici', (req, res) => {
    const { ad, soyad } = req.body;
    res.status(201).send(`Kullanıcı ${ad} ${soyad} başarıyla eklendi!`);
});

Yukarıdaki örnekte, `/kullanici` rotasına POST isteği yapıldığında, gelen veriyi alıyoruz ve kullanıcıyı başarılı bir şekilde eklediğimizi belirten bir mesaj döndürüyoruz.

Gerçek bir API, genellikle bir veritabanı ile etkileşimde bulunur. Burada, örnek olarak MongoDB’yi kullanacağız. MongoDB, NoSQL bir veritabanıdır ve JavaScript ile entegrasyonu çok kolaydır.

MongoDB'yi kurduktan sonra, veritabanına bağlanmak için `mongoose` kütüphanesini kurmamız gerekir:

npm install mongoose

Ardından, MongoDB veritabanına bağlanabilir ve kullanıcıları ekleyebiliriz:

const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/kullaniciDB', { useNewUrlParser: true, useUnifiedTopology: true });

const Kullanici = mongoose.model('Kullanici', { ad: String, soyad: String });

app.post('/kullanici', async (req, res) => {
    const { ad, soyad } = req.body;
    const yeniKullanici = new Kullanici({ ad, soyad });
    await yeniKullanici.save();
    res.status(201).send(`Kullanıcı ${ad} ${soyad} başarıyla kaydedildi!`);
});

Artık MongoDB'ye bağlanarak kullanıcı ekleyebiliyoruz!

Bir API geliştirirken, hata yönetimi çok önemlidir. Herhangi bir sorunla karşılaşıldığında, doğru hata mesajları döndürmek gerekir. Ayrıca, API'nizi güvende tutmak için çeşitli güvenlik önlemleri almanız gerekir.

app.use((err, req, res, next) => {
    console.error(err.stack);
    res.status(500).send('Bir hata oluştu!');
});

Node.js ve Express ile bir REST API yazmak gerçekten basit ve eğlenceli bir süreçtir. Bu rehberde, temel bir API’nin nasıl yazılacağını, veritabanı bağlantısının nasıl yapılacağını ve hata yönetiminin nasıl sağlanacağını öğrendiniz.

Yolculuğunuz burada bitmiyor! API’niz üzerinde daha fazla özellik ekleyebilir, güvenlik önlemleri alabilir ve performans iyileştirmeleri yapabilirsiniz. Unutmayın, her yeni projede deneyim kazandıkça daha yetkin olacaksınız!