API Tasarımı Best Practices

RESTful API Tasarım Prensipleri

İyi tasarlanmış bir API, uygulamanızın omurgasını oluşturur. İşte dikkat etmeniz gereken temel prensipler.

1. Kaynak Odaklı URL'ler

GET /api/users          # Tüm kullanıcılar
GET /api/users/123      # Tek kullanıcı
POST /api/users         # Yeni kullanıcı
PUT /api/users/123      # Kullanıcı güncelle
DELETE /api/users/123   # Kullanıcı sil

2. HTTP Metotlarını Doğru Kullanın

• GET: Veri okuma
• POST: Yeni kaynak oluşturma
• PUT/PATCH: Kaynak güncelleme
• DELETE: Kaynak silme

3. Versiyonlama

API versiyonlaması için URL'de versiyon belirtin:

/api/v1/users
/api/v2/users

4. Hata Yönetimi

Anlamlı hata mesajları ve uygun HTTP status kodları kullanın.

5. Pagination

Büyük veri setleri için pagination uygulayın:

GET /api/users?page=1&limit=20