Scope'lar

Scope (yetki), tüccarın kurulumunuza verdiği bir izindir. Uygulamaların çağırabildiği her işlem tam olarak bir scope gerektirir; bu scope referansta işlemin sayfasının en üstünde belirtilir.

13uygulama token'ının çağırabildiği işlem

9 / 52bir endpoint'in uyguladığı scope

999platform API'sindeki toplam işlem

Kurallar

write_x, read_x’i içerir. write_products verilmiş bir uygulama, ikinci bir izin olmadan okuma route’larını çağırabilir. Token’ın scope alanı genişletilmiş kümeyi zaten listeler.
Müşteri kişisel verileri ayrı bir katmandır. read_customer_pii hiçbir zaman başka bir scope tarafından ima edilmez — ne read_orders ne de read_customers tarafından. Sipariş ve müşteri route’ları uygulamalara açıldığında, kurulum bu scope’a sahip değilse kayıtlar kişisel verileri maskelenmiş olarak dönecek.
write_payments yoktur. Ödemeler platforma aittir; bir uygulama okuyabilir, asla yazamaz. Bilinmeyen bir scope istemek sessizce yok sayılmaz, reddedilir.
Joker karakter yok, admin scope’u yok. Yetkilendirme, kesin küme üyeliğidir.
Eksik scope → 403. Asla “veri yok” gibi görünen boş bir liste değil.

“Henüz hiçbir şey sağlamıyor”

Scope’ların çoğu şimdiden istenebilir ve verilebilir, ancak hiçbir endpoint onlara bakmaz — read_orders sahibi bir uygulama yine de siparişleri okuyamaz, çünkü henüz hiçbir sipariş route’u uygulamalara açık değildir. Platform bunu kendisi söyler: token yanıtı bunları scopeNotYetEnforced içinde listeler ve tüccarın izin ekranı onları işaretler. Bu durumdaki bir scope’a göre geliştirme yapmayın; referansa göre geliştirin.

Bir endpoint açıldığında, scope’u bu sitenin bir sonraki derlemesinde bu tabloda Enforced durumuna geçer.

Tüm scope’lar

Türkçe metin, tüccarın onay ekranında okuduğu metnin birebir aynısıdır.

Scope	Durum	Ayrıca verir	Tüccara gösterilen açıklama
`read_products`	Uygulanıyor	—	Ürünlerinizi, açıklamalarını, varyantlarını ve kategorilerini görebilir.
`write_products`	Uygulanıyor	`read_products`	Ürün ve kategori ekleyebilir, adlarını, açıklamalarını ve varyantlarını değiştirebilir, yayından kaldırabilir. Ürünlerinizi görme iznini kapsar.
`read_collections`	Uygulanıyor	—	Ürün koleksiyonlarınızı ve içlerinde hangi ürünlerin olduğunu görebilir.
`write_collections`	Henüz bir şey vermiyor	`read_collections`	Koleksiyon oluşturabilir, adını değiştirebilir ve içine ürün ekleyip çıkarabilir — yani vitrindeki listelerin neleri gösterdiğini belirleyebilir. Koleksiyonları görme iznini kapsar.
`read_inventory`	Uygulanıyor	—	Stok adetlerinizi ve hangi depoda ne kadar olduğunu görebilir.
`write_inventory`	Henüz bir şey vermiyor	`read_inventory`	Stok adetlerini değiştirebilir. Bir ürünü stok girerek satışa açabilir ya da sıfırlayarak satıştan düşürebilir. Stokları görme iznini kapsar.
`read_prices`	Henüz bir şey vermiyor	—	Ürün fiyatlarınızı, indirimli fiyatları ve fiyat listelerini görebilir.
`write_prices`	Henüz bir şey vermiyor	`read_prices`	Fiyatları değiştirebilir. Değiştirilen fiyat müşteriye anında görünür ve o fiyattan verilen siparişler geçerlidir. Fiyatları görme iznini kapsar.
`read_orders`	Henüz bir şey vermiyor	—	Siparişlerinizi, sipariş kalemlerini ve tutarlarını görebilir.
`write_orders`	Henüz bir şey vermiyor	`read_orders`	Sipariş oluşturabilir, sipariş durumunu ve notlarını değiştirebilir. Siparişleri görme iznini kapsar.
`read_draft_orders`	Henüz bir şey vermiyor	—	Henüz siparişe dönüşmemiş teklif ve taslak siparişleri görebilir.
`write_draft_orders`	Henüz bir şey vermiyor	`read_draft_orders`	Taslak sipariş ve teklif hazırlayabilir, içeriğini değiştirebilir. Taslakları görme iznini kapsar.
`read_fulfillments`	Henüz bir şey vermiyor	—	Siparişlerin hangi kargoyla, ne zaman gönderildiğini ve takip numaralarını görebilir.
`write_fulfillments`	Henüz bir şey vermiyor	`read_fulfillments`	Siparişleri gönderildi olarak işaretleyebilir, kargo ve takip bilgisi girebilir. Gönderileri görme iznini kapsar.
`read_returns`	Henüz bir şey vermiyor	—	İade taleplerini, sebeplerini ve durumlarını görebilir.
`write_returns`	Henüz bir şey vermiyor	`read_returns`	İade talebi açabilir, onaylayabilir veya reddedebilir. Para iadesi YAPAMAZ — ödemeye dokunan hiçbir izin bu listede yoktur. İadeleri görme iznini kapsar.
`read_customers`	Henüz bir şey vermiyor	—	Müşteri kayıtlarınızı ve sipariş geçmişlerini görebilir. Ad, e-posta, telefon ve adres gibi kişisel bilgiler bu izinle GÖRÜNMEZ; onun ayrı bir izni vardır.
`write_customers`	Henüz bir şey vermiyor	`read_customers`	Müşteri kaydı oluşturabilir, etiketleyebilir ve kayıt bilgilerini değiştirebilir. Müşterileri görme iznini kapsar; kişisel bilgileri görme iznini KAPSAMAZ.
`read_customer_pii`	Henüz bir şey vermiyor	—	🔴 Müşterilerinizin ad, e-posta, telefon ve adres bilgilerini görebilir. Bu izin tek başına durur: başka hiçbir izin bunu kendiliğinden vermez, siparişleri veya müşterileri görme izni de dahil. Vermezseniz bu bilgiler gizlenmiş olarak döner.
`read_metaobjects`	Henüz bir şey vermiyor	—	Mağazanıza özel tanımladığınız alanları ve yapılandırılmış içerik kayıtlarını görebilir.
`write_metaobjects`	Uygulanıyor	`read_metaobjects`	Mağazanıza özel alanları ve yapılandırılmış içerik kayıtlarını oluşturabilir ve değiştirebilir. Bunları görme iznini kapsar.
`read_content`	Henüz bir şey vermiyor	—	Sayfalarınızı, menülerinizi ve site içeriğinizi görebilir.
`write_content`	Henüz bir şey vermiyor	`read_content`	Sayfa ve menü oluşturabilir, metinlerini değiştirebilir. Değişiklik canlı sayfada müşteriye görünür. İçeriği görme iznini kapsar.
`read_blogs`	Henüz bir şey vermiyor	—	Blog yazılarınızı ve kategorilerini görebilir.
`write_blogs`	Uygulanıyor	`read_blogs`	Blog yazısı yazabilir, düzenleyebilir ve yayımlayabilir. Blogları görme iznini kapsar.
`read_translations`	Henüz bir şey vermiyor	—	İçeriğinizin diğer dillerdeki çevirilerini görebilir.
`write_translations`	Henüz bir şey vermiyor	`read_translations`	Çevirileri değiştirebilir — yani bir dilde mağazanızın ne yazdığını belirleyebilir. Çevirileri görme iznini kapsar.
`read_media`	Henüz bir şey vermiyor	—	Görsellerinizi, videolarınızı ve yüklediğiniz dosyaları görebilir.
`write_media`	Uygulanıyor	`read_media`	Görsel ve dosya yükleyebilir, bunların ürün ve sayfalara bağlanmasını değiştirebilir. Görselleri görme iznini kapsar.
`read_discounts`	Henüz bir şey vermiyor	—	Kupon ve indirim kurallarınızı görebilir.
`write_discounts`	Henüz bir şey vermiyor	`read_discounts`	Kupon ve indirim oluşturabilir ve değiştirebilir. Oluşturulan bir indirim müşteri tarafından hemen kullanılabilir. İndirimleri görme iznini kapsar.
`read_shipping`	Henüz bir şey vermiyor	—	Kargo yöntemlerinizi, teslimat bölgelerinizi ve ücretlerinizi görebilir.
`write_shipping`	Henüz bir şey vermiyor	`read_shipping`	Kargo yöntemi, bölge ve ücretlerini değiştirebilir — yani müşterinin ödeme sayfasında hangi teslimat seçeneğini kaça göreceğini belirler. Kargo ayarlarını görme iznini kapsar.
`read_payments`	Henüz bir şey vermiyor	—	Ödeme yöntemi ayarlarınızı ve ödemelerin durumunu görebilir. Ödemeler yalnızca OKUNUR: CIQRA'da ödeme yazma izni diye bir şey yoktur, bu yüzden hiçbir bağlantı tahsilat yapamaz, para iadesi veremez veya bir ödemeyi iptal edemez.
`read_forms`	Henüz bir şey vermiyor	—	Form tanımlarınızı ve gelen form yanıtlarını görebilir.
`write_forms`	Henüz bir şey vermiyor	`read_forms`	Form oluşturabilir ve alanlarını değiştirebilir. Formları görme iznini kapsar.
`read_support`	Henüz bir şey vermiyor	—	Destek taleplerini ve yazışmalarını görebilir.
`write_support`	Henüz bir şey vermiyor	`read_support`	Destek talebi açabilir, durumunu değiştirebilir ve talebe not düşebilir. Destek taleplerini görme iznini kapsar.
`read_loyalty`	Henüz bir şey vermiyor	—	Sadakat programınızı, puanları ve üyelik seviyelerini görebilir.
`write_loyalty`	Henüz bir şey vermiyor	`read_loyalty`	Sadakat puanı ekleyip çıkarabilir ve program kurallarını değiştirebilir — yani müşterinin elindeki puanın değerini belirleyebilir. Sadakat verilerini görme iznini kapsar.
`read_reviews`	Henüz bir şey vermiyor	—	Ürün değerlendirmelerini ve puanlarını görebilir.
`write_reviews`	Henüz bir şey vermiyor	`read_reviews`	Değerlendirmeleri onaylayabilir, gizleyebilir veya yanıtlayabilir — yani hangi yorumun vitrinde görüneceğini belirler. Değerlendirmeleri görme iznini kapsar.
`read_themes`	Henüz bir şey vermiyor	—	Temanızı ve tema dosyalarınızı görebilir.
`write_themes`	Henüz bir şey vermiyor	`read_themes`	Tema dosyalarını ve ayarlarını değiştirebilir. Temayı YAYIMLAYAMAZ — yayımlama, mağazanızın herkese görünen halini değiştirdiği için hiçbir bağlantıya verilmez. Temayı görme iznini kapsar.
`read_sites`	Henüz bir şey vermiyor	—	Mağaza ayarlarınızı ve site yapılandırmanızı görebilir. Bu ayarlar yalnızca OKUNUR: CIQRA'da mağaza ayarı yazma izni diye bir şey yoktur.
`read_seo`	Henüz bir şey vermiyor	—	Arama motoru başlıklarınızı, açıklamalarınızı ve yönlendirmelerinizi görebilir.
`write_seo`	Henüz bir şey vermiyor	`read_seo`	Arama motoru başlık ve açıklamalarını, yönlendirmeleri ve site haritası ayarlarını değiştirebilir — yani mağazanızın aramalarda nasıl göründüğünü belirler. SEO ayarlarını görme iznini kapsar.
`read_analytics`	Henüz bir şey vermiyor	—	Satış, ziyaret ve dönüşüm raporlarınızı görebilir. Raporlar yalnızca OKUNUR: CIQRA'da ölçüm verisi yazma izni diye bir şey yoktur.
`read_webhooks`	Uygulanıyor	—	Yalnızca kendi oluşturduğu bildirim aboneliklerini listeleyebilir.
`write_webhooks`	Uygulanıyor	`read_webhooks`	Mağazanızda bir şey olduğunda kendisine bildirim gitmesi için abonelik oluşturabilir ve silebilir. Kendi aboneliklerini görme iznini kapsar.
`read_app_data`	Henüz bir şey vermiyor	—	Yalnızca kendi sakladığı ayar ve verileri okuyabilir. Mağazanızın verilerine erişmez.
`write_app_data`	Henüz bir şey vermiyor	`read_app_data`	Yalnızca kendi ayar ve verilerini saklayabilir ve değiştirebilir. Mağazanızın verilerine dokunmaz. Kendi verilerini okuma iznini kapsar.