REST, bir API tasarım tarzıdır. Her veri türü bir "kaynak" olarak düşünülür ve kendi adresi vardır: ürünler, siparişler, iadeler. Bu kaynaklar üzerinde HTTP yöntemleriyle işlem yapılır. Veri çoğunlukla JSON biçiminde gider ve gelir. Trendyol, Hepsiburada, Çiçeksepeti, Pazarama ve WooCommerce API'leri REST tarzındadır.
HTTP yöntemleri
| Yöntem | Anlamı | Pazaryeri örneği |
|---|---|---|
| GET | Okur | Sipariş paketlerini listelemek |
| POST | Oluşturur ya da işlem başlatır | Yeni ürün yüklemek, stok güncelleme isteği göndermek |
| PUT | Var olanı günceller | Bir kaydın bilgisini değiştirmek |
| DELETE | Siler | Bir kaydı kaldırmak |
Gerçek bir istek
Saystok'un Trendyol bağlantısı stok güncellemek için price-and-inventory ucuna POST isteği gönderir. Gövde bir items listesidir ve her öğede şu alanlar bulunur:
- barcode: ürünün barkodu
- quantity: yeni stok adedi
Fiyat güncellemesinde quantity yerine salePrice ve listPrice gönderilir. Trendyol isteği kabul edince bir batchRequestId döndürür. İşlemin sonucu bu kimlikle ayrıca sorgulanır; ayrıntı toplu işlem maddesinde.
REST, SOAP ve GraphQL
| Konu | REST | SOAP | GraphQL |
|---|---|---|---|
| Veri biçimi | Çoğunlukla JSON | XML zarf | JSON |
| Adres yapısı | Her kaynak için ayrı uç | Tek servis, farklı işlemler | Tek uç, sorguyla alan seçimi |
| Öğrenme kolaylığı | Yüksek | Düşük | Orta |
| Pazaryeri örneği | Trendyol, Hepsiburada | N11 soru-cevap servisi | ikas Admin API |
Durum: N11'in geçişi
N11'in API'si uzun süre SOAP ile çalıştı. Ürün, stok-fiyat ve sipariş servisleri artık REST ile sunulur. Ürün soruları gibi bazı işlemlerin ise yalnız SOAP karşılığı vardır. Bu yüzden N11 entegrasyonu iki tarzı birlikte kullanır. Ayrıntı: N11 API rehberi.
Satıcı için anlamı
REST bilmek zorunda değilsiniz, ama terimi bilmek entegrasyon firmasıyla konuşurken işe yarar. "REST API var mı?" sorusu, platformun modern ve belgelenmiş bir arayüz sunup sunmadığını anlamanın kısa yoludur.