Partner Portal
T-SOFT/Storefront API/Sürümler

Sürümler

Storefront API'nin sürüm sözleşmesi ve dokümanda yayınlanan değişikliklerin günlüğü bu sayfadadır.

Doküman sürümü v1.9.0·API sürümü 2026-01·Son güncelleme: 18 Eylül 2026—değişiklikler için değişiklik günlüğü

Sürüm politikası

Storefront API sürümleri path içinde tarihli olarak taşınır (2026-01). Sürüm sözleşmesi:

  • Kararlılık. Yayındaki bir sürümün yanıt yapısı sessizce değişmez. Yeni bir alan eklenebilir; ama var olan bir alan kaldırılmaz veya tipi değiştirilmez.
  • Yeni sürüm. Breaking bir değişiklik gerektiğinde yeni tarihli bir sürüm (2026-07 gibi) altında yayınlanır; mevcut sürüm bir süre paralel yayında kalır ve geçiş için zaman tanınır.
  • Kaldırma öncesi uyarı. Bir alan kaldırılacaksa önce kullanımdan kaldırıldı (deprecated) olarak işaretlenir; kaldırma daha sonraki bir sürümde gerçekleşir. Bu süre, entegrasyonunuzu güncellemeniz için geçiş penceresidir.

Değişiklik günlüğü

Bu doküman, API sürümünden (2026-01) bağımsız olarak kendi doküman sürümüyle (SemVer) takip edilir. Yayına alınan yeni kaynaklar, eklenen alan ve filtreler ile kullanımdan kaldırılan alanlar burada duyurulur. Entegrasyonunuzu güncel tutmak için bu günlüğü takip edin.

Doküman sürümü: 1.9.0 — API sürümü: 2026-01

Sürümleme kuralı: MAJOR doküman yapısı kökten değişince, MINOR yeni kaynak/sayfa eklenince, PATCH mevcut sayfada düzeltme yapılınca artar.

1.9.0 — 18 Eylül 2026

Bu sürümde üç davranış, mevcut bir entegrasyonun gördüğü sonucu değiştirebilir: fiyata göre sıralama artık gösterilen fiyatı kullanıyor, indirim filtresinin döndürdüğü küme vitrinle hizalandı ve favori listesi varsayılan olarak en son eklenenden başlıyor.
  • Yeni sayfa: Ürün filtreleri — ürün listesinin filtre panelini ve sıralama seçeneklerini tek istekte veren product-facets kaynağı: kategoriler, markalar, modeller, özellikler, varyant eksenleri, fiyat aralığı, aç/kapa filtreleri, sıralama seçenekleri ve mağazanın varsayılan sıralaması.
  • Yeni filtre: ürünlerde filter[modelId], filter[variantType1Id], filter[variantType2Id], filter[isNew] ve özellik seçimi için filter[attr].
  • Yeni sıralama: ürünlerde -viewCount, -recommendationCount, -commentCount, -favoriteCount, random ve position. Favorilerde createdAt.
  • Yeni alan: ürün detayında orderNoteEnabled; Uygulama Yapılandırması bayraklarında showLoyaltyPointsOnProductDetail ve showOrderNoteOnProductDetail; menü öğelerinde displayInMobile ve hasChildren.
  • Davranış: ürünlerde sort=price artık gösterilen fiyata göre sıralar — üye grubuna özel fiyat veya indirim varsa sıralama onu dikkate alır. Fiyat aralığı filtresi ham liste fiyatına bakmaya devam eder.
  • Davranış: filter[hasDiscount], ürünün mağazada indirimli olarak gösterilme işaretine hizalandı; vitrinde indirimli görünen küme ile filtrenin döndürdüğü küme artık aynı.
  • Davranış: favori listesi sort verilmediğinde en son eklenen başta döner (önceki sıra en eskiden yeniyeydi).
  • Davranış: kategori listesi mağazanın verdiği manuel sıraya, eşitlikte kayıt numarasına göre döner — aynı istek her çağrıldığında aynı sırayı verir.
  • Davranış: kategori listesi ile menüler artık aynı görünürlük kümesini kullanıyor; menüde gizlenmiş ama mobilde gösterilmek üzere işaretlenmiş kategoriler her iki kaynakta da dönüyor.
  • Davranış: MENU_MOBILE menüsünde veya X-Storefront-Platform: ios|android başlığı gönderildiğinde kategori menüsü mobilde gösterilmeyen kategorileri düşürür; alt öğesi olan kategorilerin listesi ebeveyne giden bir kısayolla açılır.
  • Davranış: ürün özellikleri (attributes) artık ürün listesinde de alınabiliyor — fields[products]=attributes ile istenir, varsayılan yanıtta yer almaz.
  • Doküman: Yorum puan dağılımı sayfasına verilen bağlantılar düzeltildi — önceki adres sayfayı açmıyordu.
  • Doküman: ürünlerde symbols ve attributes alanlarının yapısı, sepet satırında stock, stockUnit, stockIncrement, puan önizlemesinde pointsValue ve ödeme seçeneklerinin görünürlük kuralı belgelendi.

Daha eski sürümler

SürümTarihDeğişiklik
1.8.02026-08Yeni kaynak: comment-rating-breakdowns — ürünün yıldız kırılımı, toplam yorum sayısı ve puan ortalaması. Yeni uç: PATCH cart-items/{id}/notes — sepet satırına sipariş notu, hediye notu ve hediye paketi tercihi; ilgili alanlar orderNote, giftNote, giftPackage. Yeni alanlar: ürünlerde vatIncluded, vatRate ve isNew; Uygulama Yapılandırması para birimi listesinde symbol ve symbolPosition. Yeni filtreler: siparişlerde filter[status], filter[orderDateFrom], filter[orderDateTo]. Davranış: ürünün KDV gösterim ayarı açıkken price ve discountPrice artık KDV dahil döner — fiyatın üzerine istemcide KDV eklenmemelidir. Davranış: ödeme adımı tamamlanmamış siparişler listede ve tekil istekte dönmez. Davranış: ürün yorumları en yeniden eskiye sıralanır; adını gizleyen yorum sahibinin adı boş string yerine maskeli döner (A** V***).
1.7.12026-07Route'da açık olduğu hâlde sayfalarda anlatılmayan tekil kayıt uçları belgelendi: kategoriler, favoriler, fiyat alarmları ve destek talepleri için GET /{kaynak}/{id}. Hesap kaynaklarında başka bir müşterinin kaydının 404 döndüğü, kategorilerde isActive alanının pratikte her zaman true olduğu netleştirildi.
1.7.02026-07Yeni sayfa: Uygulama Yapılandırması — açılışta gereken sürüm, dil, para birimi ve özellik bayrakları. Yeni sayfa: Link Çözümleme — URL veya slug'ı ürün, kategori, marka gibi bir hedefe çözer. Kimlik Doğrulama sayfasına sosyal giriş (POST customer/token/social; Google, Apple, Facebook) ve oturum kapatma (DELETE customer/token, ?all=1 ile tüm cihazlar) bölümleri eklendi.
1.6.02026-07Yeni sayfa: Ödeme Devri — uygulamadan web ödeme sayfasına oturum devri; üye ve misafir devir uçları, tek kullanımlık kısa ömürlü token ve dönüş yolu izin listesi. Yeni sayfa: Yorum Yazma — POST product-comments ve görselli varyantı POST product-comments/with-image, moderasyon kuyruğu ve gönderim kısıtlarıyla. Yorumlar sayfası yazma ucuna bağlandı.
1.5.02026-07Yeni sayfa: Sepet — sepet okuma, satır ekleme/güncelleme/silme, kupon ve kampanya uygulama; appliedCoupon, appliedCampaign, discountTotal, grandTotal alanları ve koşullu kargo/minimum sipariş alanları belgelendi. Yeni sayfa: Misafir Sepeti — misafir sepet token'ı ve girişte sepet birleşmesi.
1.4.22026-07Ürünler sayfası genişletildi: liste yanıtı artık zarfıyla (meta.page + links) gösteriliyor, sayfalama davranışı ve bitiş tespiti anlatıldı, tüm attributes alanlarını kapsayan Alanlar tablosu eklendi, varyantların included[] örneği ve options yapısı belgelendi. Düzeltme: Include örneğinde filter[categoryId] yerine geçen hatalı filter[category] yazımı ve hasDiscount filtresinin yetkiye bağlı davranışı netleştirildi.
1.4.12026-07Yeni alanlar: siparişlere ödeme ve tutar kırılımı alanları eklendi — paymentMethod, installment, bank, coupon, subtotal, shippingCost, discount; adres form alanlarına yerelleştirilmiş etiket title eklendi.
1.4.02026-07Yeni kaynak: representatives — mağazanın satış temsilcileri; kayıtta representativeCode ile müşteriye bağlanır. Yeni sayfa: Üye Kaydı ve Parola Kurtarma — kayıt, SMS ile kayıt doğrulama ve şifremi unuttum akışları. Yeni sayfa: Kayıt Form Alanları — üye kayıt formunun girişsiz alınabilen dinamik alan yapılandırması. Yeni sayfa: Görsel Yükleme — ürün kişiselleştirme görseli ve sepette görselli sipariş notu.
1.3.12026-07Yeni alanlar: ürünlere stock (ham stok adedi, storefront:read scope'lu token'da döner); adreslerde identityNumber artık okumada maskeli döner (son 4 hane açık); fiyat alarmlarına alarmDay (alarmın toplam geçerlilik süresi); destek mesajlarına recordLink (mesaja iliştirilen ek dosya bağlantısı). Ayrıca doküman iyileştirmeleri: sayfa üstlerindeki yetki notları kısaltıldı, kategori sayfasındaki bölüm başlıkları sadeleştirildi.
1.3.02026-07Yeni kaynak: loyalty-earning-previews — ürün başına tahmini puan kazanımı. Ürünlere yeni alanlar eklendi: brandId, ratingAverage, commentCount, isOpportunity, opportunityEndsAt. Yeni filtreler: filter[hasDiscount], filter[isOpportunity], filter[categoryId]. Yeni sıralama: sort=name.
1.2.02026-07Üç yeni kaynak yayında ve belgelendi: payment-options (taksit tablosu), cargo-companies, menus. filter[categoryId] artık kategori ağacında alt dalları da kapsar ve virgülle çoklu kategori kabul eder. Ürünler sayfasına Include'lar bölümü eklendi.
1.1.02026-07Ürünlere filter[brandId] (marka id ile, çoklu) filtresi eklendi. Sadakat hareketleri createdAt/expiresAt alanları Unix zaman damgası (saniye) olarak döner.
1.0.02026-07İlk tam sürüm: 29 kaynak (katalog + hesap katmanı), yetki (scope) rozetleri, kimlik doğrulama akışları.

Geri bildirim

Bu API'yi kullanırken karşılaştığınız beklenmedik davranışları, eksik alan taleplerini veya sözleşme belirsizliklerini destek kanalınız üzerinden bildirebilirsiniz.