[{"id":"2026-11-10-admin-api-surum-politikasi","audience":"gelistirici","version":"2026-11-10","label":"API 2026-01","apiVersion":"2026-01","sunset":null,"link":"https://developer.tsoft.com.tr/api/surumler","date":"2026-11-10","title":"Admin API sürüm politikası ve sürüm başlıkları","summary":"Admin API sürümleri çeyreklik çıkar ve her sürüm, kendinden sonraki sürüm yayınlandıktan en az 12 ay desteklenir.","points":["Her yanıt, hata yanıtları dahil, isteğin işlendiği sürümü X-TSoft-Api-Version başlığında bildirir","Kullanımdan kalkacak sürüm, uç ve alanlar Deprecation, Sunset ve Link başlıklarıyla duyurulur","Var olmayan bir sürüm (ör. 2025-10) JSON:API 404 api_version_unsupported döner; desteklenen sürümler meta.supportedVersions içindedir","Desteği biten sürüm 410 api_version_retired döner; istek başka bir sürüme sessizce yönlendirilmez","Sıradaki sürüm 2027-01; 2026-01 en erken Ocak 2028'de kalkar"],"listed":true,"body":[],"howto":"İstemcinizde sürümü adreste sabit tutun ve yanıtlardaki Deprecation ya da Sunset başlıklarını kaydedin; bu başlıkları gördüğünüzde Sunset tarihinden önce yeni sürüme geçin.","cat":"admin-api","type":"yeni"},{"id":"2026-11-07-gizlilik-webhooklari","audience":"gelistirici","version":"2026-11-07","label":"","apiVersion":null,"sunset":null,"link":"https://developer.tsoft.com.tr/uygulama-gelistirme/webhooks#gizlilik-webhookları","date":"2026-11-07","title":"Gizlilik webhook'ları: shop.redact ve customers.redact","summary":"Uygulama kaydındaki privacy_url adresine, mağaza ya da müşteri verisini silmeniz gerektiğinde imzalı bildirim gelir.","points":["shop.redact: uygulama mağazadan kaldırıldıktan 48 saat sonra gelir; bu sürede yeniden kurulursa gönderilmez","customers.redact: mağaza bir müşteriyi sildiğinde customer_ids ile gelir","Gövde, imza ve claim'ler kaldırma bildirimiyle aynıdır (ES256, aynı JWKS)"],"listed":true,"body":[],"howto":"Mağaza ya da müşteri verisi tutuyorsanız tsoft.app.toml içinde [webhooks] privacy_url tanımlayın ve iki olayda ilgili veriyi silin.","cat":"webhook","type":"yeni"},{"id":"2026-11-07-musteri-kisisel-verisi-kapsami","audience":"gelistirici","version":"2026-11-07","label":"API 2026-01","apiVersion":"2026-01","sunset":null,"link":"https://developer.tsoft.com.tr/uygulama-gelistirme/kapsamlar#müşteri-kişisel-verisi","date":"2026-11-07","title":"Müşteri kişisel verisi read_customer_personal_data kapsamıyla açılıyor","summary":"read_orders siparişi verir ama siparişi veren kişiyi tanıtan alanları vermez; bu alanlar yeni read_customer_personal_data kapsamı ya da read_customers ile dolu gelir.","points":["Kapsam yoksa orders içindeki customerFirstName, customerLastName, customerEmail ve customerPhone null döner; istek yine 200 ile başarılı olur","order-addresses içindeki ad, adres, telefon ve vergi numarası alanları da aynı kurala bağlıdır","İl, ilçe ve ülke gibi bölge bilgisi her zaman gelir"],"listed":true,"body":[],"howto":"Kargo etiketi ya da fatura kesiyorsanız uygulamanıza read_customer_personal_data kapsamını ekleyin ve bu alanların null gelebileceğini hesaba katın.","cat":"oauth","type":"iyi"},{"id":"2026-11-06-panel-kartlari-ve-modal-aksiyonlar","audience":"gelistirici","version":"2026-11-06","label":"","apiVersion":null,"sunset":null,"link":"https://developer.tsoft.com.tr/uygulama-gelistirme/embedded-uygulamalar","date":"2026-11-06","title":"Panele gömülü uygulamalar: sayfada kartlar ve modal aksiyonlar","summary":"Uygulamalar panel sayfalarına kart ekleyebilir ve modal içinde aksiyon açabilir.","points":[],"listed":false,"body":[],"howto":"","cat":"app-bridge","type":"yeni"},{"id":"2026-11-03-storefront-katalog-token-zorunlu","audience":"gelistirici","version":"2026-11-03","label":"API 2026-01","apiVersion":"2026-01","sunset":null,"link":"https://developer.tsoft.com.tr/storefront-api/kimlik-dogrulama","date":"2026-11-03","title":"Storefront katalog uçlarında client token zorunlu","summary":"Ürün, kategori ve marka gibi katalog uçları artık token'sız istek kabul etmiyor; Authorization başlığı olmayan istek 401 döner.","points":[],"listed":false,"body":[],"howto":"Katalog isteklerinin her birinde storefront:read taşıyan client token'ını Authorization başlığında gönderin.","cat":"storefront-api","type":"iyi"},{"id":"2026-11-03-admin-api-urun-ve-varyant-yazma","audience":"gelistirici","version":"2026-11-03","label":"API 2026-01","apiVersion":"2026-01","sunset":null,"link":"https://developer.tsoft.com.tr/api/urunler","date":"2026-11-03","title":"Admin API: ürün ve varyant yazma","summary":"Ürün ve varyant oluşturma ve güncelleme uçları belgelendi ve uygulamalara açıldı.","points":[],"listed":false,"body":[],"howto":"","cat":"admin-api","type":"yeni"}]