REST API Nedir?
REST API, REST mimari ilkelerine dayanan ve standart web araçlarıyla çağrılabilen HTTP tabanlı uygulama programlama arayüzüdür; pazaryeri, altyapı ve kargo entegrasyonlarında sık kullanılır.
Diğer Adları: REST, RESTful API
REST API Nasıl Çalışır?
MDN’ye göre REST (Representational State Transfer), verimli, güvenilir ve ölçeklenebilir dağıtık sistemler ortaya çıkaran yazılım mimarisi kısıtlarının adıdır. Temel fikir, belge gibi bir kaynağın iyi bilinen, dilden bağımsız ve standartlaşmış istemci-sunucu etkileşimleriyle aktarılmasıdır; bu kısıtlara uyan hizmetlere RESTful denir.
Uygulamada REST API, ürün, sipariş ya da stok gibi her kaynağın bir adresle temsil edildiği ve isteğin türünün HTTP yöntemiyle belirtildiği bir hizmettir: kayıt okumak için GET, oluşturmak için POST gibi. Trendyol satıcı API’sinde örneğin webhook oluşturma isteği, adresinde satıcı kimliği bulunan bir uç noktaya POST yöntemiyle gönderilir ve başarılı yanıt webhook kimliğini döner.
REST API ile GraphQL Farkı
REST API’de her kaynak için ayrı uç noktalar bulunur ve yanıtın hangi alanları içereceğini sunucu belirler. GraphQL’de ise istemci, istediği alanları sorguda kendisi seçer. MDN ayrıca HTTP API’lerin hepsinin REST kısıtlarının tamamına uymadığını, gündelik dilde genel olarak HTTP API’lere REST API denildiğini belirtir.
REST API Entegrasyonunda Dikkat Edilecekler
- Kimlik doğrulama bilgisi (API anahtarı ya da erişim belirteci) yalnızca sunucuda tutulur.
- Yanıttaki HTTP durum kodları okunur; 400, 401 ve 500 gibi hatalar ayrı ayrı ele alınır.
- Sağlayıcının istek sınırlarına uyulur; çok sayıda kayıt için sayfalama ya da toplu işlem kullanılır.
- Değişiklikleri sık sık sorgulamak yerine, sağlayıcı destekliyorsa webhook ile bildirim alınır.
Örnek: Bir mağaza pazaryerindeki sipariş durumlarını her dakika REST API ile sorgular ve sipariş sayısı arttıkça istek sınırına takılır. Sipariş durum değişiklikleri için webhook kurulduğunda sorgu sayısı azalır; sorgu yalnızca bildirimi gelmeyen kayıtları denetlemek için kullanılır.
REST API Hakkında Sık Sorulan Sorular
REST API ile API aynı şey mi?
REST API, API’nin bir türüdür. API yazılımlar arasındaki her türlü bağlantı yöntemini anlatır; REST API ise HTTP üzerinden REST ilkeleriyle çalışan türüdür.
REST API hangi veri biçimini kullanır?
REST belirli bir veri biçimi şart koşmaz. E-ticaret entegrasyonlarında yanıtlar çoğunlukla JSON, bazı eski hizmetlerde XML biçimindedir.