Django REST Framework Nasıl Kullanılır? Basit Adımlarla API Geliştirme

Django'nun gücünü bilenler, bir de üzerine Django REST Framework (DRF) ile web uygulamalarında API'ler oluşturmanın ne kadar kolay olduğunu keşfettiğinde, işin keyfi bir başka oluyor. Eğer sen de Django kullanarak web uygulamanı geliştirdiysen ve bu uygulamaya RESTful API eklemek istiyorsan, o zaman bu yazı tam sana göre!

Django, Python dilinde yazılmış güçlü bir web framework’ü. Ancak, Django'nun asıl gücü sadece veritabanı yönetimi ya da kullanıcı doğrulaması gibi işlemlerle sınırlı değil. Django, web uygulaman için mükemmel bir API desteği sunarak, uygulamanın dış dünyayla konuşmasını sağlayan RESTful servisler oluşturmanı kolaylaştırır. İşte tam burada devreye Django REST Framework giriyor.

Django REST Framework, Django ile uyumlu bir kütüphane olup, REST API'lerini kolayca oluşturmanı sağlar. Kendi uygulamanı geliştirirken bir API'nin nasıl oluşturulması gerektiği konusunda hiç kafanı yormadan bu güçlü araçla hızlıca API'ler oluşturabilirsin.

Django REST Framework kullanmaya başlamak için ilk adım, öncelikle bu kütüphaneyi projene dahil etmek. Django projenin kök dizininde terminali açarak şu komutu çalıştır:

pip install djangorestframework

Kurulum tamamlandıktan sonra, Django projenin `settings.py` dosyasına gidip `INSTALLED_APPS` kısmına aşağıdaki satırı eklemen yeterli olacak:

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

Bu kadar! Şimdi Django REST Framework ile API oluşturmak için gerekli her şeye sahipsin.

Şimdi asıl eğlenceli kısma geliyoruz: API'yi oluşturma. Django'da, bir view (görünüm) bir URL isteği aldığında ne yapması gerektiğini belirler. DRF ile bu süreci çok daha kolay bir hale getirebiliyorsun. Diyelim ki bir `Book` modelimiz var ve bu modelin tüm verilerini API üzerinden erişilebilir kılmak istiyoruz.

Önce `models.py` dosyasına gidip aşağıdaki gibi bir model oluşturalım:

from django.db import models

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

    def __str__(self):
        return self.title

Modelimizi oluşturduktan sonra, bu modelin verilerini API üzerinden göstermek için bir serializer’a ihtiyacımız olacak. Serializer, Django modellerini JSON formatına dönüştürmemizi sağlar. Bunu `serializers.py` dosyasına yazabiliriz:

from rest_framework import serializers
from .models import Book

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

Serializer’ı oluşturduktan sonra, `views.py` dosyasına gidip bir API view oluşturalım. Burada DRF'nin sunduğu `APIView` sınıfını kullanacağız:

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` sınıfı `GET` isteklerini karşılayacak ve tüm kitapları JSON formatında döndürecek. Son olarak, URL’yi yapılandırmak için `urls.py` dosyasına aşağıdaki satırı ekliyoruz:

from django.urls import path
from .views import BookList

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

Şimdi, `http://localhost:8000/books/` adresine gittiğinde, tüm kitapların JSON formatında verilerini görebileceksin!

Şimdiye kadar her şey yolunda gitti, ancak API'nin güvenliği de çok önemli. Django REST Framework, güvenlik için yerleşik çözümler sunuyor. Örneğin, kullanıcılara yetki vermek için `permissions` özelliğini kullanabilirsin.

Örneğin, sadece giriş yapmış kullanıcıların API'ye erişebilmesi için şu şekilde bir güvenlik ekleyebiliriz:

from rest_framework.permissions import IsAuthenticated

class BookList(APIView):
    permission_classes = [IsAuthenticated]

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

Bu şekilde, yalnızca kimlik doğrulaması yapılmış kullanıcılar API verilerine erişebilir.

Django REST Framework ile API geliştirdiğin zaman, performansı göz ardı etmemek çok önemli. Özellikle veritabanından büyük veri setleri çekiyorsan, API’nin performansını artırmak için pagination (sayfalama) kullanmak iyi bir fikir olacaktır.

Django REST Framework, sayfalama işlemini kolayca yapmanı sağlar. `settings.py` dosyasına şu satırı eklemen yeterli olacak:

REST_FRAMEWORK = {
    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
    'PAGE_SIZE': 10,
}

Bu ayar ile API çağrılarında sadece 10 veri gösterilecek ve sayfalama desteği devreye girecektir.

Django REST Framework kullanarak güçlü ve hızlı bir API geliştirmek oldukça basit. Birkaç adımda uygulamanın dış dünyaya açılmasını sağlayacak API'yi kolayca oluşturabiliyorsun. Django'nun sağladığı kolaylık ve DRF'nin sunduğu özelliklerle, API geliştirme süreci çok daha eğlenceli hale geliyor. Eğer Django ile REST API geliştirme konusunda yeniysen, bu yazı seni baştan sona kadar yönlendirecek ve başarılı bir API oluşturmanı sağlayacak.

Unutma, Django REST Framework ile API'lerin ne kadar güçlü ve esnek olabileceğini keşfettikçe, bu araç sana çok daha fazlasını sunacak. Şimdi, elindeki bu bilgileri projelerine uygulamaya başla ve harika API'ler yarat!