API Teknik Referans Kılavuzu

API Mimari Türleri

REST (Representational State Transfer)

Stateless (durumsuz) yapıdadır. HTTP metodlarını kullanır. Web'in %90'ı bu mimariyle çalışır.

JSON / XML

GraphQL

İstemci ihtiyacı olan veriyi kendisi tanımlar. Under-fetching ve over-fetching sorunlarını çözer.

Query Language

gRPC / WebSockets

Yüksek performanslı, binary veri transferi (Protobuf) veya çift yönlü gerçek zamanlı iletişim sağlar.

Binary / Streaming

HTTP Durum Kodları (Hata ve Başarı)

200 OK: İstek başarılı.

201 Created: Yeni kaynak oluşturuldu.

401 Unauthorized: Yetkisiz erişim.

404 Not Found: Kaynak bulunamadı.

429 Too Many Requests: Rate limit aşıldı.

500 Internal Server Error: Sunucu hatası.

İleri Düzey Güvenlik ve Optimizasyon

Kimlik Doğrulama

OAuth2 & OpenID: Üçüncü taraf uygulamaların veriye güvenli erişimi için endüstri standardı.

mTLS: İstemci ve sunucunun karşılıklı olarak birbirini sertifika ile doğrulaması.

Performans Kontrolü

Rate Limiting: API'nin kötüye kullanımını engellemek için dakika başı istek sınırlama.

Caching (Redis): Sık kullanılan yanıtların bellekte tutularak yanıt süresinin milisaniyelere indirilmesi.