Endpoint Nedir?
İngilizce: API Endpoint
REST endpoint, belirli bir kaynağa veya işleme HTTP metodu ve URL yolu üzerinden erişim sağlayan API giriş noktasıdır.
Endpoint Nedir?
Endpoint, bir API’de istemcinin istek gönderdiği belirli giriş noktasıdır. REST yaklaşımında endpoint genellikle bir URL yolu ve HTTP metodundan oluşur: GET /api/v1/users kullanıcı listesini okurken POST /api/v1/users yeni kullanıcı oluşturabilir.
Endpoint yalnızca adres değildir; hangi verinin kabul edildiği, hangi yetkinin gerektiği, hangi durum kodlarının döneceği ve hataların nasıl bildirileceği de endpoint sözleşmesinin parçasıdır.
Nasıl Tasarlanır?
İyi bir REST endpoint tasarımında kaynak isimleri, metotlar ve yanıtlar tutarlı olmalıdır:
- GET: Kaynak okuma
- POST: Yeni kaynak veya işlem oluşturma
- PUT/PATCH: Kaynağı tamamen veya kısmen güncelleme
- DELETE: Kaynağı silme veya pasifleştirme
- Status code:
200,201,400,401,404,409gibi anlamlı HTTP yanıtları
Versiyonlama (/v1), pagination, filtreleme, rate limit ve hata formatı dokümantasyonda açıkça yazılmalıdır.
İş Dünyasında Kullanımı
API entegrasyonlarında endpoint kalitesi, karşı sistemle çalışmanın hızını belirler. Muhasebe fişi oluşturma, kargo etiketi alma, stok güncelleme veya ödeme sonucu sorgulama gibi işlemler açık endpoint sözleşmeleriyle güvenilir hale gelir.
REST API projelerinde belirsiz endpoint adları ve tutarsız hata yanıtları entegrasyon maliyetini artırır. Bu yüzden endpoint tasarımı yalnız backend detayı değil, ürünün dışarıya verdiği teknik sözleşmedir.