Express.js ile API Geliştirme: Adım Adım Kılavuz

Merhaba sevgili geliştirici! Eğer bir API oluşturmak istiyorsanız, doğru yerdesiniz. Çünkü bugün size Express.js ile nasıl kolayca bir API geliştirebileceğinizi anlatacağım. Express.js, Node.js üzerinde çalışan, son derece hızlı ve basit bir web framework'üdür. Özellikle API geliştirme için harika bir seçenek. Hem güçlü hem de öğrenmesi oldukça kolay!

Şimdi dilerseniz adım adım Express.js ile bir API nasıl geliştirileceğini inceleyelim.

Express.js ile çalışmaya başlamadan önce, bilgisayarınızda Node.js yüklü olmalıdır. Hemen Node.js'i indirmek için [resmi web sitesine](https://nodejs.org) gidebilirsiniz. Node.js yüklendikten sonra, Express.js'i projeye dahil edelim.

Komut satırınıza şu komutu yazın:

npm init -y

Bu komut, bir package.json dosyası oluşturacaktır. Şimdi Express'i yükleyelim:

npm install express

Bu işlem tamamlandığında Express.js proje klasörünüze dahil edilmiş olacak.

Şimdi, Express.js ile temel bir sunucu kurmaya başlıyoruz. Öncelikle app.js isminde bir dosya oluşturuyoruz ve içine şu kodu ekliyoruz:

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

app.get('/', (req, res) => {
  res.send('Merhaba, Express API!');
});

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

Burada neler yaptık? İlk olarak Express'i import ettik. Ardından bir GET isteği ile / (ana sayfa) yoluna gelen istekleri karşıladık ve basit bir metin döndürdük. En son olarak, 3000 numaralı portu dinlemeye başladık.

Sunucuyu çalıştırmak için terminal üzerinden şu komutu yazabilirsiniz:

node app.js

Eğer her şey doğruysa, tarayıcınızda http://localhost:3000 adresine gittiğinizde "Merhaba, Express API!" mesajını görmelisiniz.

Express.js ile birden fazla API endpoint’i oluşturmak çok kolay! Mesela, kullanıcılar hakkında bilgi almak isteyebiliriz. Şimdi bir /users API endpoint'i oluşturacağız.

İlk önce /users yoluna gelen GET isteklerini yakalayalım ve kullanıcıları listeleyelim:

const users = [
  { id: 1, name: 'Ali', age: 28 },
  { id: 2, name: 'Ayşe', age: 25 },
  { id: 3, name: 'Mehmet', age: 32 }
];

app.get('/users', (req, res) => {
  res.json(users);
});

Burada kullanıcıların olduğu bir dizi oluşturduk. /users endpoint'ine gelen GET isteklerine karşılık, bu kullanıcıların listesini JSON formatında döndürüyoruz.

Bir API geliştirirken, genellikle verileri sunucuya göndermeniz gerekir. Express.js, POST isteklerini de çok kolay bir şekilde yönetmenizi sağlar.

Örneğin, bir kullanıcı eklemek için şu adımları takip edelim:

app.use(express.json()); // JSON formatındaki verileri alabilmek için middleware ekliyoruz

app.post('/users', (req, res) => {
  const newUser = req.body;
  users.push(newUser);
  res.status(201).json(newUser); // Yeni kullanıcıyı ekledik ve başarı mesajı döndük
});

Burada, express.json() middleware'i ile JSON formatındaki verileri alabiliyoruz. Gelen veriyi req.body üzerinden alıp, kullanıcılar listesine ekliyoruz. Yeni eklenen kullanıcıyı 201 Created statüsü ile geri gönderiyoruz.

Her API'nin düzgün çalışması için hata yönetimi çok önemlidir. Express.js ile basit bir hata yönetimi eklemek oldukça kolay. İşte bir örnek:

app.use((req, res, next) => {
  const error = new Error('Yol bulunamadı');
  error.status = 404;
  next(error); // Hata iletisini bir sonraki middleware'e gönderiyoruz
});

app.use((error, req, res, next) => {
  res.status(error.status || 500);
  res.json({
    message: error.message
  });
});

Burada, önce 404 Not Found hatası oluşturuyoruz. Eğer kullanıcı geçersiz bir yol girerse, hata mesajını dönüyoruz.

İşte bu kadar! Express.js ile hızlıca bir API geliştirdik. Şimdi API’niz GET, POST ve hata yönetimi gibi temel özelliklere sahip. Bu API’yi çok daha kapsamlı hale getirmek için ek özellikler, veritabanı entegrasyonu ve kimlik doğrulama gibi işlevler ekleyebilirsiniz. Express.js’in kolay yapısı sayesinde çok hızlı bir şekilde geliştirmeye devam edebilirsiniz.

API geliştirmek hiç bu kadar eğlenceli olmamıştı, değil mi? Şimdi sıra sizde! Haydi, Express.js ile kendi projelerinizi geliştirmeye başlayın.