Express.js ile API Geliştirmeye Giriş
Herkese merhaba! Eğer bu yazıyı okuyorsanız, büyük ihtimalle Express.js ile API geliştirmeye başlamak istiyorsunuz. Ama endişelenmeyin, doğru yerdesiniz. Bugün sizinle, Express.js'in gücünü keşfedecek, basit bir API nasıl geliştirileceğini öğreneceğiz.
Diyelim ki bir projede backend tarafında çalışıyorsunuz ve ihtiyacınız olan şey bir API. İhtiyaç duyduğunuz veri ile etkileşime geçecek, veri gönderecek ve alacak bir sistem. İşte tam bu noktada Express.js devreye giriyor.
Express.js, Node.js üzerine inşa edilmiş hafif ve güçlü bir web uygulama çatısıdır. API'ler ve web uygulamaları geliştirmek için mükemmel bir araçtır. Şimdi, adım adım Express.js ile basit bir API nasıl yapılır, öğrenelim.
1. Adım: Express.js'i Kurma
İlk adım, Express.js'i projenize dahil etmek olacak. Eğer Node.js yüklü değilse, hemen Node.js'i indirip kurabilirsiniz. Node.js'in en son sürümünü indirdikten sonra, terminal veya komut satırını açın ve aşağıdaki komutla yeni bir Node.js projesi başlatın:
kopyalanpm init -y
Bu komut, package.json dosyasını oluşturacak. Şimdi Express.js'i yüklemeye başlayalım. Aşağıdaki komutu terminalinize yazın:
kopyalanpm install express
Bunun ardından Express.js, projenize eklenmiş olacak ve kullanıma hazır hale gelecek.
2. Adım: Basit Bir API Oluşturma
Şimdi, basit bir Express.js API'si yaratmaya başlayalım. Aşağıdaki kodu `app.js` gibi bir dosya içine yapıştırabilirsiniz:
kopyalaconst express = require('express'); const app = express(); // API endpoint oluşturma app.get('/', (req, res) => { res.send('Merhaba, Express API!'); }); // API'yi dinlemeye başlama app.listen(3000, () => { console.log('API 3000 portunda çalışıyor...'); });
Bu basit API, ziyaretçilere "Merhaba, Express API!" mesajını döndürecektir. Şimdi terminalden şu komutla uygulamayı başlatabilirsiniz:
kopyalanode app.js
Eğer her şey yolunda giderse, artık http://localhost:3000 adresine gittiğinizde bu mesajı görmelisiniz.
3. Adım: Dinamik API Endpoints Eklemek
Şimdi, biraz daha dinamik bir şeyler yapalım. Örneğin, kullanıcılara kişisel bilgi gönderebileceğimiz bir API endpoint’i ekleyelim. Aşağıdaki kodu, `app.js` dosyasına ekleyelim:
kopyalaapp.get('/users/:id', (req, res) => { const userId = req.params.id; res.json({ id: userId, name: `User ${userId}`, email: `user${userId}@example.com` }); });
Bu API endpoint’i, `:id` parametresi alacak ve buna göre dinamik bir kullanıcı bilgisi döndürecek. Örneğin, http://localhost:3000/users/1 adresine giderseniz, aşağıdaki gibi bir JSON yanıtı alırsınız:
```json
{
"id": "1",
"name": "User 1",
"email": "user1@example.com"
}
```
4. Adım: POST ve PUT İstekleri ile API'yi Zenginleştirmek
Sadece veri almak değil, veri göndermek de çok önemli. Şimdi, POST isteği ile bir kullanıcı oluşturmak için basit bir örnek yapalım. Bunun için Express.js’in express.json() middleware’ini kullanacağız.
Aşağıdaki kodu ekleyelim:
kopyalaapp.use(express.json()); app.post('/users', (req, res) => { const newUser = req.body; newUser.id = Date.now(); // Basit bir id üretme res.status(201).json(newUser); });
Bu API, bir kullanıcı oluşturmak için POST isteği alır ve gelen JSON verisini döner. Mesela, Postman veya benzeri bir araçla POST http://localhost:3000/users isteği gönderdiğinizde şu yanıtı alırsınız:
```json
{
"id": 1617975392671,
"name": "John Doe",
"email": "johndoe@example.com"
}
```
5. Adım: Hata Yönetimi ve Sonraki Adımlar
API geliştirdikçe, hata yönetimi de önem kazanır. Express.js ile hataları yönetmek oldukça kolaydır. Örneğin, bir kullanıcıyı bulamazsanız, şu şekilde bir hata yanıtı döndürebilirsiniz:
kopyalaapp.get('/users/:id', (req, res) => { const userId = req.params.id; if (userId === '0') { res.status(404).json({ error: 'Kullanıcı bulunamadı!' }); } else { res.json({ id: userId, name: `User ${userId}`, email: `user${userId}@example.com` }); } });
API'nizi geliştirdikçe, JSON Web Token (JWT) ile güvenlik, veri doğrulama gibi daha ileri düzey konuları keşfetmeye başlayabilirsiniz.
Sonuç: Express.js ile API Geliştirme Kolay ve Eğlenceli
Gördüğünüz gibi, Express.js ile API geliştirmek oldukça kolay ve hızlı bir süreç. Basit bir yapı ile başlayıp, ihtiyacınıza göre fonksiyonel ve güvenli API'ler yaratabilirsiniz. Bu yazıdaki temel adımları takip ederek, backend geliştirmenin temellerini öğrenmiş oldunuz.
Yolculuğunuzun başlangıcına hoş geldiniz! Hedefiniz her zaman kullanıcılarınıza değer sunmak olmalı. Express.js gibi güçlü araçlarla, işleriniz çok daha kolay hale gelecek.
Hadi, projenizi geliştirmeye başlayın ve Express.js’in gücünden faydalanın!