Özel domain ve mağaza durumları

Operatör /magazalar ekranından API domainini ekler. DNS değişikliği gerekmez. www ve kök domain ayrı kaydedilir. Domain başka mağazanın shop-code veya tokenıyla kullanılamaz. Bakımda müşteri uçları 503 storefront.maintenance; pasif mağazada çevrimiçi işlemler 403 shop.inactive döner. Origin kimlik doğrulama değildir; sunucu isteklerinde API anahtarı kullanın.

İki ayrı kayıt

API domaini, örneğin deneme.com, sitenizden gelen HTTPS Origin’in mağazaya bağlanmasını sağlar. www.deneme.com ayrıca kaydedilir. Sarraf operatörü bu kayıtları mağaza detayında ekleyip kaldırır; TXT doğrulaması istenmez. Aynı hostname başka mağazaya atanamaz; ayrılmış Sarraf adresleri kullanılamaz.

Sitenizi kendi sunucunuzda barındırın; DNS ve HTTPS’i o sunucuya göre kurun. API domainini eklemek hosting veya SEO ana vitrin adresini değiştirmez. Starter’da NUXT_SITE_ORIGIN tam HTTPS origin olmalıdır; kaydedilen hostname ile eşleşir.

# Yalnız public okuma örneği; Origin kimlik/yetki kanıtı değildir.
curl https://api.sarraf.net/site/categories \
  -H 'Origin: https://deneme.com'

Origin olmayan sunucu entegrasyonlarında API anahtarı kullanın. Public okumalarda açık shop-code seçimi de desteklenir. Header, kayıtlı Origin ve token farklı mağazaları gösterirse çelişki reddedilir; birini diğerinin üzerine yazmayın. Domain kaldırıldıktan sonra otomatik çözümleme durur.

Durum ekranları

Durum	HTTP	Davranış
Bulunamadı	404	Hostname/mağaza kaydını kontrol edin.
Pasif / siliniyor	403	Otomatik tekrar durur; mağaza operatörüyle görüşülür.
Bakım / hazırlanıyor	503	Kullanıcıya bekleme ve yeniden deneme gösterilir.
Geçici bağlantı sorunu	502/503	Retry-After gözetilerek sınırlı tekrar yapılır.

HTML sayfaları arama motoruna indekslenmez ve tenant hataları ortak cache’e alınmaz. API istemcileri kararlı JSON code alanını kullanır. Bakımda personel operasyonları açıktır; pasifte worker işlemleri de durur. Başlamış işler güvenli sınırına gelene kadar panel “Durduruluyor” gösterir.