REST API nedir?

REST API nedir, nasıl çalışır?

Mağazanız bir kargo yazılımına, muhasebe programına ya da pazaryerine bağlandığında aradaki konuşma çoğunlukla REST API üzerinden yürür. İstemci bir adrese istek yapar, sunucu da genellikle JSON biçiminde yanıt döner. REST bir protokol değil, tasarım ilkeleri bütünüdür; MDN sözlüğü bunu REST maddesinde (yeni sekmede açılır) anlatır.

Mağazanızdaki sipariş, ürün ve müşteri kayıtlarının her biri ayrı bir kaynaktır ve kendi adresi vardır. Bir sistem öbürünün verisine bu adres üzerinden ulaşır.

REST API yöntemleri nelerdir?

REST API yöntemleri, yapılacak işi belirten HTTP fiilleridir: GET okur, POST yeni kayıt oluşturur, PUT ve PATCH günceller, DELETE siler. Aynı adres, kullanılan yönteme göre farklı iş yapar. Aşağıdaki adresler temsilî örnektir.

• GET /orders: sipariş listesini okur.
• POST /orders: yeni sipariş oluşturur.
• PATCH /orders/123: siparişin bir alanını değiştirir.
• DELETE /orders/123: siparişi siler.

REST API örneği: e-ticarette nerede kullanılır?

REST API örneği olarak bir kargo yazılımını düşünün: yeni siparişleri mağazanızdan çeker, gönderi oluşturur ve sipariş durumunu "kargolandı" yapar. Pazaryerleri, ERP ve muhasebe yazılımlarının çoğu da bu yolla veri alışverişi yapar. Birden çok sistemi bağlamak için Entegrasyon ve Otomasyon Marketi sayfasındaki hazır çözümlere bakabilirsiniz.

REST API ile SOAP arasındaki fark nedir?

REST API, SOAP'a göre daha hafif ve esnektir: SOAP her mesajı katı bir XML zarfında taşırken REST, adresler ve HTTP yöntemleriyle çalışır ve JSON gibi sade biçimler kullanabilir. Eski kurumsal sistemlerde SOAP hâlâ görülür; yeni web servislerinin çoğu REST sunar. Bir entegrasyon kurarken karşı tarafın hangisini sunduğuna bakmak, hangi aracı seçeceğinizi belirler.

Yanıt kodları ne anlatır?

Sunucu her isteğe bir durum kodu ile döner: 200 işlemin başarılı olduğunu, 404 kaynağın bulunamadığını, 401 doğrulamanın başarısız olduğunu, 429 istek sınırının aşıldığını gösterir. Entegrasyonun bu kodlara göre davranması gerekir; örneğin 429 geldiğinde bir süre bekleyip isteği yeniden denemelidir.

API belgesini nasıl okursunuz?

Her API'nin bir belgesi olur: adresler, kabul ettiği yöntemler, istekte gönderilecek alanlar ve dönen yanıtın biçimi orada listelenir. Entegrasyona başlamadan önce okuma (GET) isteğiyle bir deneme yapın; veriyi değiştiren isteklere ancak yanıtın yapısını gördükten sonra geçin. Önce test ortamında denemek, canlı mağaza kaydını yanlışlıkla değiştirmenizi önler.

Nelere dikkat etmek gerekir?

İstekler API anahtarı ya da OAuth ile doğrulanmalı, bağlantı HTTPS üzerinden kurulmalıdır. Sunucunun istek sınırı aşıldığında hata döner; bu yüzden toplu işlemler parçalara bölünmeli, hata kodları (örneğin 404 ya da 429) kayda alınmalıdır.

e-Ticarette nerede kullanılır?

• Mağaza siparişlerinin kargo yazılımına aktarılması
• Stok ve fiyatın ERP ile eşitlenmesi
• Pazaryeri ürün ve sipariş verisinin çekilmesi
• Muhasebe yazılımına fatura bilgisinin gönderilmesi

REST API hakkında sık sorulanlar