3D vitrindeki ürün paneli veriyi sayfanın içinden değil, bir servis ucundan çekiyor. Bu sayfa o akışın nasıl kurulduğunu ve Yataş tarafındaki sistemle nasıl birleşeceğini anlatıyor.
Vitrinde bir ürüne tıklandığında tarayıcı şu isteği yapıyor:
GET /api/urun/agata_koltuk_uclu.json
Yanıt panele bağlanıyor ve panelin altında hangi uçtan kaç milisaniyede geldiği yazıyor. Tarayıcının ağ sekmesinden doğrulanabilir. Servise ulaşılamazsa panel sayfa içindeki yedek katalogdan gösteriyor ve bunu ekranda belirtiyor — kesintide ekran boş kalmıyor.
Uçtaki veri şu an örnektir. Fiyat, stok ve stok kodları gerçek değildir; gerçek olan, çağrının kendisi ve veri sözleşmesidir.
Vitrin doğrudan SAP'ye bağlanmıyor. Aradaki katman üç işi üstleniyor: SAP'ye gelen istek sayısını önbellekle düşürmek, kimlik bilgilerini tarayıcıdan uzak tutmak, ve alan adlarını sabit tutarak arkadaki sistem değişse bile arayüzü etkilememek.
Bu katmanı Yataş kendi tarafında yazabilir, biz de yazabiliriz. Bizim
için değişen tek şey API_KOK sabiti; çağrı biçimi ve alan
adları aynı kaldığı sürece vitrin tarafında kod değişmiyor.
Panelin kullandığı alanlar ve SAP tarafındaki tipik karşılıkları. Kesin karşılıklar Yataş'ın kurulumuna göre netleşir; aşağıdaki sütun bir başlangıç önerisidir.
| Panel alanı | Anlamı | Tipik SAP karşılığı |
|---|---|---|
stokKodu | Ürün kimliği | Malzeme numarası (MATNR) |
ad | Ürün adı | Malzeme kısa metni (MAKTX) |
fiyat | Satış fiyatı | Fiyat koşulu (KONP / PR00) |
eskiFiyat | Liste fiyatı | Liste fiyat koşulu |
taksit | Kampanya metni | Kampanya servisi (SAP dışı olabilir) |
secenek | Ölçü / gövde seçenekleri | Varyant karakteristikleri |
kumas | Kumaş / renk varyantı | Varyant konfigürasyonu |
url | Ürün detay sayfası | e-ticaret ürün URL'i |
Kumaş varyantları 3B model tarafında da karşılık buluyor: glTF'in kendi varyant özelliği (KHR_materials_variants) ile seçim modelin dokusunu birebir değiştiriyor. Varyant kodları kartelayla eşlendiğinde panelden yapılan seçim doğrudan doğru kumaşı gösteriyor.
Bunların hiçbiri vitrinin çalışması için önkoşul değil; bugün örnek veriyle çalışıyor. Geldiklerinde ara katmanın kaynağı değişiyor, arayüz tarafında iş çıkmıyor.