REST API nedir sorusu, yalnızca araç adını ezberlemekle cevaplanmaz. REST API, api stili olarak Kaynakları HTTP fiilleri ve durum kodlarıyla temsil eden, yaygın kullanılan bir API stili. İyiWeb teknoloji kütüphanesinde REST API, proje keşfinde doğru seçilip seçilmediğini netleştirmek için anlatılır; her kayıt otomatik uzmanlık veya sabit fiyat vaadi taşımaz.
REST, bir ürün değil bir arayüz stilidir. Müşteri, sipariş veya ürün gibi kaynaklar adreslenir; okuma, oluşturma ve güncelleme HTTP fiilleriyle ayrılır. Birçok ödeme, kargo ve muhasebe bağlantısı bu stille yayınlanır. İyi kurulmuş bir uç, alan adlarını, hataları ve sayfalama kuralını tutarlı tutar.
İsim tek başına kalite getirmez. Sürüm, kimlik, sınır ve hata gövdesi yazılmazsa istemci her değişiklikte kırılır. Webhook, olayın size gelmesidir; REST ise sizin kaynağı çekmeniz veya yazmanızdır. İkisi karıştırılınca ya sürekli sorgu ya da kaçırılan olay oluşur.
REST API ne işe yarar diye bakıldığında asıl ölçüt, iş kuralının, arayüzün veya veri akışının hangi katmanda çözüleceğidir. Yanlış katmanda seçilen araç bakım maliyetini artırır; doğru seçim ise barındırma, ekip ve entegrasyon kısıtlarıyla uyumlu kalır.
Kurumsal bir REST API projesinde kapsam, kabul kriterleri ve hariçler yazılı olmalıdır. Sürüm, lisans ve güvenlik güncellemesi politikası keşif notuna eklenir. Bu sayfa REST API için karar çerçevesi sunar; nihai mimari keşif sonrası belirlenir.
Yaygın istemci
HTTP bilen her dil çağırabilir. Özel bir SDK şart olmayabilir. REST API kararında bu madde keşif tutanağına yazılarak diğer seçeneklerle karşılaştırılır.
Kaynak dili
Adres ve fiil, neyin okunup neyin yazıldığını ekibe anlatır. REST API kararında bu madde keşif tutanağına yazılarak diğer seçeneklerle karşılaştırılır.
Önbellek ve günlük
GET ile yazma ayrımı, izleme ve tekrar denemeyi kolaylaştırır. REST API kararında bu madde keşif tutanağına yazılarak diğer seçeneklerle karşılaştırılır.
01
Lead’den CRM’e akış
Form veya webhook tetikleyicisinin REST API ile CRM kaydına dönmesi. Tipik kapsam: Sistemler arası kaynak uçları.
02
Sipariş sonrası otomasyon
Ödeme sonrası fatura, kargo veya bildirim zinciri. Tipik kapsam: Ön yüzün konuştuğu arka uç.
03
İç araçlar arası köprü
Tablo, e-posta ve destek aracının tek senaryoda bağlanması. Tipik kapsam: Üçüncü taraf HTTP entegrasyonu.
Sipariş ve stok sistemlerinin birbirine bağlanması
REST API kapsamında bu iş kalemi planlanır: Sipariş ve stok sistemlerinin birbirine bağlanması.
Mobil veya ön yüzün arka ucu okuması
REST API kapsamında bu iş kalemi planlanır: Mobil veya ön yüzün arka ucu okuması.
Üçüncü taraf ödeme ve kargo çağrıları
REST API kapsamında bu iş kalemi planlanır: Üçüncü taraf ödeme ve kargo çağrıları.
Mevcut uçların hata ve sürüm sözleşmesinin yazılması
REST API kapsamında bu iş kalemi planlanır: Mevcut uçların hata ve sürüm sözleşmesinin yazılması.
REST API, tekrarlayan manuel işleri senaryoya bağlamak isteyen operasyon ve IT ekipleri için uygundur.
Karar, ekibin REST API deneyimi, barındırma modeli ve mevcut sistemlerle uyuma bakılarak verilir. İyiWeb keşifte bu ölçütleri tablolaştırır; seçim teklifte gerekçesiyle yazılır.