Node.js ile Supabase Kullanarak CRUD API Oluşturma
Merhaba! Fatih Soysal olarak, bugün sizlere Node.js ve Supabase kullanarak güçlü ve ölçeklenebilir bir CRUD (Create, Read, Update, Delete) API oluşturmayı adım adım anlatacağım. Supabase, PostgreSQL veritabanını temel alan açık kaynaklı bir platformdur. Bu platform, backend geliştirmeyi oldukça kolaylaştırır ve hızlı prototipleme için idealdir. Node.js ile birleştirdiğimizde ise, performanslı ve modern bir API elde ederiz.
Gerekli Kurulumlar
Öncelikle, projemize başlamadan önce birkaç paket kurmamız gerekiyor. Bunun için npm veya yarn kullanabiliriz. İşte gereken paketler:
npm install express pg@8.11.0 @supabase/supabase-js
Bu komut, Express.js (API oluşturmak için), pg (PostgreSQL bağlantısı için) ve @supabase/supabase-js (Supabase ile etkileşim için) paketlerini kuracaktır. pg@8.11.0 belirtilmesi önemlidir; çünkü Supabase ile uyumluluk sağlamak için bu versiyonu kullanmalıyız. Kurulumdan sonra, Supabase projenizi oluşturmalı ve API anahtarlarınızı almalısınız. Daha sonra bu anahtarları kodunuzda kullanacaksınız.
API Yapısı
Şimdi, basit bir kullanıcı yönetimi API’si oluşturalım. Bu API, kullanıcıları ekleme, listeleme, güncelleme ve silme işlemlerini destekleyecektir. Aşağıda, temel API yapısını gösteren Node.js kodu yer almaktadır:
const express = require('express');
const { createClient } = require('@supabase/supabase-js');
const app = express();
app.use(express.json());
// Supabase bağlantı bilgileri
const supabaseUrl = 'YOUR_SUPABASE_URL';
const supabaseKey = 'YOUR_SUPABASE_ANON_KEY';
const supabase = createClient(supabaseUrl, supabaseKey);
// Kullanıcı ekleme
app.post('/users', async (req, res) => {
try {
const { data, error } = await supabase
.from('users')
.insert(req.body);
if (error) throw error;
res.status(201).json(data);
} catch (error) {
res.status(500).json({ error: error.message });
}
});
// Kullanıcıları listeleme
app.get('/users', async (req, res) => {
try {
const { data, error } = await supabase
.from('users')
.select('*');
if (error) throw error;
res.json(data);
} catch (error) {
res.status(500).json({ error: error.message });
}
});
// Kullanıcı güncelleme
app.put('/users/:id', async (req, res) => {
// ... (Güncelleme işlemi)
});
// Kullanıcı silme
app.delete('/users/:id', async (req, res) => {
// ... (Silme işlemi)
});
const port = 3000;
app.listen(port, () => console.log(Sunucu ${port} portunda çalışıyor.));
Bu kodda, öncelikle gerekli paketleri import ediyoruz. Daha sonra, Supabase bağlantı bilgilerini ayarlıyoruz. YOUR_SUPABASE_URL ve YOUR_SUPABASE_ANON_KEY yer tutucularını kendi Supabase proje bilgilerinizle değiştirmeyi unutmayın. Sonrasında, kullanıcı ekleme, listeleme, güncelleme ve silme işlemlerini gerçekleştirmek için ilgili route’ları tanımlıyoruz. async/await kullanımı kodun okunabilirliğini ve yönetimini kolaylaştırıyor.
Hata Yönetimi ve Güvenlik
Önemli bir nokta da hata yönetimi ve güvenliktir. Yukarıdaki kodda, try…catch bloğu kullanarak olası hataları yakalıyoruz ve kullanıcıya uygun bir hata mesajı döndürüyoruz. Ayrıca, güvenlik açıklarını önlemek için, giriş doğrulama ve yetkilendirme gibi ek güvenlik önlemleri almanız önerilir. Daha güvenli bir uygulama için JWT (JSON Web Token) kullanabilirsiniz. Bunu fatihsoysal.com sitesindeki diğer makalelerimde daha detaylı bulabilirsiniz.
Sonuç
Bu makalede, Node.js ve Supabase kullanarak basit bir CRUD API oluşturmayı öğrendik. Supabase’in sunduğu kolaylıklar sayesinde, backend geliştirme sürecini oldukça hızlandırabilir ve daha verimli bir şekilde çalışabiliriz. Umarım bu makale size yardımcı olmuştur. Daha fazla bilgi ve örnekler için, Supabase dokümantasyonuna ve diğer kaynaklara göz atabilirsiniz. Supabase Dokümantasyonu
Not: Bu makalede verilen kod örnekleri, temel bir yapı oluşturmak amacıyla verilmiştir. Gerçek dünya uygulamaları için daha kapsamlı hata yönetimi, güvenlik önlemleri ve doğrulama işlemlerinin eklenmesi gerekebilir.
#Etiketler: Node.js, Supabase, CRUD API, PostgreSQL, JavaScript, Backend, API Geliştirme, Veritabanı, API, Hata Yönetimi, Güvenlik