Django REST Framework ile API Geliştirme: Adım Adım Başlangıç Rehberi

Merhaba arkadaşlar! Bugün sizlere, Python ile web geliştirme dünyasında oldukça popüler bir framework olan Django'nun gücünü nasıl RESTful API'lere dönüştürebileceğinizi göstereceğim. Django REST Framework (DRF), Django uygulamalarınızda API'ler oluşturmayı son derece kolaylaştıran bir araçtır. Eğer bir web uygulamanız varsa ve harici sistemlerle veri alışverişi yapmak istiyorsanız, işte tam size göre bir rehber!

Django REST Framework, Django üzerinde RESTful API'ler oluşturmak için kullanılan güçlü bir araçtır. API'ler, özellikle modern web uygulamaları için veri iletimi ve alımı işlemleri için vazgeçilmezdir. DRF, Django’nun sunduğu tüm özellikleri bir arada sunar ve aynı zamanda API geliştirme sürecinizi hızlandırır. Sadece backend tarafında değil, frontend ile iletişimde de işleri kolaylaştırır.

Hadi şimdi işin teknik kısmına geçelim. Django ve DRF'yi projeye dahil etmek oldukça basit!

Öncelikle Python ortamınızda Django'yu ve DRF'yi kurmanız gerekecek. Eğer henüz Python ve pip'i yüklemediyseniz, ilk adım olarak bunları yüklemeniz lazım. Terminal veya komut satırınızı açın ve aşağıdaki komutları girin:

pip install django
pip install djangorestframework

Bu işlem tamamlandığında, projenizi oluşturabilirsiniz. Yeni bir Django projesi başlatmak için aşağıdaki komutu girin:

django-admin startproject myproject

Şimdi proje dizinine gidip Django'yu başlatabiliriz:

cd myproject
python manage.py runserver

Projeniz çalışmaya başladığında, tarayıcınızda `http://127.0.0.1:8000/` adresine giderek Django’nun varsayılan sayfasını görebilirsiniz.

Django REST Framework’ü projeye dahil etmek için, `settings.py` dosyanızda `INSTALLED_APPS` kısmına DRF'yi eklemeniz yeterli.

INSTALLED_APPS = [
    # Diğer uygulamalar
    'rest_framework',
]

Bu sayede DRF, projede kullanılabilir hale gelecektir.

Şimdi asıl eğlenceli kısma geliyoruz! Django ile API oluşturmanın temeli, “view” (görünüm) ve “serializer” (serileştirici) kavramlarından geçiyor. İlk adım olarak, veri modelinizi tanımlamanız gerekebilir.

Örneğin, basit bir model oluşturalım:

from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=100)
    published_date = models.DateField()

    def __str__(self):
        return self.title

Burada `Book` modelini oluşturduk. Bu modelde bir kitabın başlığı, yazarı ve yayımlandığı tarih bilgilerini saklayacağız. Modeli oluşturduktan sonra, veritabanınızı güncellemeyi unutmayın:

python manage.py makemigrations
python manage.py migrate

Şimdi, bu model için bir serializer sınıfı oluşturalım. Serializer, verileri JSON formatına dönüştürmek için kullanılır.

from rest_framework import serializers
from .models import Book

class BookSerializer(serializers.ModelSerializer):
    class Meta:
        model = Book
        fields = '__all__'

Sonrasında, verileri sunmak için bir API view (görünüm) ekleyeceğiz. Bu görünüm, kullanıcıların kitap listesine erişebilmesini sağlayacak.

from rest_framework.views import APIView
from rest_framework.response import Response
from .models import Book
from .serializers import BookSerializer

class BookList(APIView):
    def get(self, request):
        books = Book.objects.all()
        serializer = BookSerializer(books, many=True)
        return Response(serializer.data)

Burada, `BookList` görünümü ile tüm kitapları veritabanından çekiyoruz ve bunları JSON formatında döndürüyoruz.

Son olarak, bu API görünümünü bir URL’ye bağlamamız gerekiyor. `urls.py` dosyasına şu kodu ekleyin:

from django.urls import path
from .views import BookList

urlpatterns = [
    path('api/books/', BookList.as_view(), name='book-list'),
]

Bu işlemle birlikte, artık `http://127.0.0.1:8000/api/books/` adresine gittiğinizde, kitaplarınızın bir listesini JSON formatında görebileceksiniz.

Eğer API’nize veri eklemek isterseniz, POST isteği kullanarak kitap ekleyebilirsiniz. Bunun için API görünümünü biraz daha geliştirelim:

class BookList(APIView):
    def get(self, request):
        books = Book.objects.all()
        serializer = BookSerializer(books, many=True)
        return Response(serializer.data)

    def post(self, request):
        serializer = BookSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data, status=201)
        return Response(serializer.errors, status=400)

Artık, `POST` isteğiyle kitap ekleyebilirsiniz. Bunun için bir API istemcisi (örneğin Postman) kullanarak JSON verilerini gönderebilirsiniz.

Ve işte bu kadar! Django REST Framework ile API oluşturmak oldukça basit ve hızlı bir işlem. DRF, API geliştirmeyi çok daha kolay hale getiriyor ve projelerinizde etkili bir şekilde kullanabileceğiniz güçlü bir araçtır.

Umarım bu rehber sizin için faydalı olmuştur. Django ile API geliştirme serüveninize başlamak için bu temel adımları takip edebilirsiniz. Her zaman daha fazlasını öğrenmek ve geliştirmek için yeni projeler yaratmaya devam edin!