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.

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

17istenebilir scope — hepsi uygulanıyor

2247platform 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.

İstenebilen her scope uygulanır

Bir scope yalnızca bir şey ona bakıyorsa sunulur — referanstaki bir endpoint ya da webhook teslim kapısı (read_customers customer.* olaylarını, read_forms form.submitted olayını, read_blogs blog_post.* olaylarını alır; read_customer_pii bir teslimattaki kişisel veri alanlarını korur). Başka bir scope istemek — manifestte, kurulumda ya da scope değişikliğinde — unpublished_scope ile reddedilir.

İstenebilen 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.
read_inventory	Uygulanıyor	—	Stok adetlerinizi ve hangi depoda ne kadar olduğunu görebilir.
read_orders	Uygulanıyor	—	Siparişlerinizi, sipariş kalemlerini ve tutarlarını görebilir.
write_orders	Uygulanıyor	read_orders	Sipariş oluşturabilir, sipariş durumunu ve notlarını değiştirebilir. Siparişleri görme iznini kapsar.
read_customers	Uygulanıyor	—	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.
read_customer_pii	Uygulanıyor	—	🔴 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	Uygulanıyor	—	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	Uygulanıyor	—	Sayfalarınızı, menülerinizi ve site içeriğinizi görebilir.
read_blogs	Uygulanıyor	—	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.
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_forms	Uygulanıyor	—	Form tanımlarınızı ve gelen form yanıtlarını görebilir.
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.

Ayrılmış scope’lar

Bu adlar tanımlıdır ancak bir endpoint onları uygulayana kadar istenemez; bu yüzden onlara göre geliştirme yapamazsınız. Bir endpoint açıldığında, scope’u bu sitenin bir sonraki derlemesinde yukarıdaki tabloya geçer. Ayrılmadan önce bu scope’lardan birini almış bir kurulum onu korur; yine de hiçbir şey sağlamaz.

Scope	Durum	Ayrıca verir	Tüccara gösterilen açıklama
write_collections	Ayrılmış — istenemez	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.
write_inventory	Ayrılmış — istenemez	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	Ayrılmış — istenemez	—	Ürün fiyatlarınızı, indirimli fiyatları ve fiyat listelerini görebilir.
write_prices	Ayrılmış — istenemez	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_draft_orders	Ayrılmış — istenemez	—	Henüz siparişe dönüşmemiş teklif ve taslak siparişleri görebilir.
write_draft_orders	Ayrılmış — istenemez	read_draft_orders	Taslak sipariş ve teklif hazırlayabilir, içeriğini değiştirebilir. Taslakları görme iznini kapsar.
read_fulfillments	Ayrılmış — istenemez	—	Siparişlerin hangi kargoyla, ne zaman gönderildiğini ve takip numaralarını görebilir.
write_fulfillments	Ayrılmış — istenemez	read_fulfillments	Siparişleri gönderildi olarak işaretleyebilir, kargo ve takip bilgisi girebilir. Gönderileri görme iznini kapsar.
read_returns	Ayrılmış — istenemez	—	İade taleplerini, sebeplerini ve durumlarını görebilir.
write_returns	Ayrılmış — istenemez	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.
write_customers	Ayrılmış — istenemez	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.
write_content	Ayrılmış — istenemez	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_translations	Ayrılmış — istenemez	—	İçeriğinizin diğer dillerdeki çevirilerini görebilir.
write_translations	Ayrılmış — istenemez	read_translations	Çevirileri değiştirebilir — yani bir dilde mağazanızın ne yazdığını belirleyebilir. Çevirileri görme iznini kapsar.
read_media	Ayrılmış — istenemez	—	Görsellerinizi, videolarınızı ve yüklediğiniz dosyaları görebilir.
read_discounts	Ayrılmış — istenemez	—	Kupon ve indirim kurallarınızı görebilir.
write_discounts	Ayrılmış — istenemez	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	Ayrılmış — istenemez	—	Kargo yöntemlerinizi, teslimat bölgelerinizi ve ücretlerinizi görebilir.
write_shipping	Ayrılmış — istenemez	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	Ayrılmış — istenemez	—	Ödeme yöntemi ayarlarınızı ve ödemelerin durumunu görebilir. Bu izinle ödemeler yalnızca OKUNUR: hiçbir bağlantı tahsilat yapamaz, para iadesi veremez veya bir ödemeyi iptal edemez.
write_forms	Ayrılmış — istenemez	read_forms	Form oluşturabilir ve alanlarını değiştirebilir. Formları görme iznini kapsar.
read_support	Ayrılmış — istenemez	—	Destek taleplerini ve yazışmalarını görebilir.
write_support	Ayrılmış — istenemez	read_support	Destek talebi açabilir, durumunu değiştirebilir ve talebe not düşebilir. Destek taleplerini görme iznini kapsar.
read_loyalty	Ayrılmış — istenemez	—	Sadakat programınızı, puanları ve üyelik seviyelerini görebilir.
write_loyalty	Ayrılmış — istenemez	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	Ayrılmış — istenemez	—	Ürün değerlendirmelerini ve puanlarını görebilir.
write_reviews	Ayrılmış — istenemez	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	Ayrılmış — istenemez	—	Temanızı ve tema dosyalarınızı görebilir.
write_themes	Ayrılmış — istenemez	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	Ayrılmış — istenemez	—	Mağaza ayarlarınızı ve site yapılandırmanızı görebilir. Bu izin yalnızca OKUR; ayar değişikliği hazırlamak ayrı bir izindir.
read_seo	Ayrılmış — istenemez	—	Arama motoru başlıklarınızı, açıklamalarınızı ve yönlendirmelerinizi görebilir.
write_seo	Ayrılmış — istenemez	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	Ayrılmış — istenemez	—	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_app_data	Ayrılmış — istenemez	—	Yalnızca kendi sakladığı ayar ve verileri okuyabilir. Mağazanızın verilerine erişmez.
write_app_data	Ayrılmış — istenemez	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.
read_settings	Ayrılmış — istenemez	—	Mağaza ayarlarınızı (diller, bildirimler, e-posta şablonları, yasal metinler, çerez ve güvenlik ayarları) görebilir.
write_settings	Ayrılmış — istenemez	read_settings	Mağaza ayarlarında değişiklik hazırlayabilir. Müşterilere giden bildirimleri ve e-postaları, yasal metinleri ve güvenlik ayarlarını yalnızca HAZIRLAR; uygulamayı siz yaparsınız. Ayarları görme iznini kapsar.
read_ai	Ayrılmış — istenemez	—	Yapay zekâ ayarlarınızı, kullanımınızı ve kredi bakiyenizi görebilir.
write_ai	Ayrılmış — istenemez	read_ai	Yapay zekâ ayarlarını değiştirebilir ve yapay zekâ ile metin ya da görsel hazırlatabilir. Üretimler kredi harcar. Yapay zekâ bilgilerini görme iznini kapsar.
read_billing	Ayrılmış — istenemez	—	Planınızı, faturalarınızı ve kullanım bilgilerinizi görebilir.
write_billing	Ayrılmış — istenemez	read_billing	Plan, ek paket ve ödeme yöntemi değişikliklerini yalnızca HAZIRLAR; para çeken hiçbir işlemi kendisi yapamaz. Faturalama bilgilerini görme iznini kapsar.
read_integrations	Ayrılmış — istenemez	—	Bağladığınız uygulamaları, pazar yeri ve ERP entegrasyonlarını ve webhook'larınızı görebilir. Bağlantı anahtarlarını ve şifreleri görmez.
write_integrations	Ayrılmış — istenemez	read_integrations	Entegrasyon ve webhook ayarlarında değişiklik hazırlayabilir; pazar yerlerine veri gönderen eşitleme ve yayın işlemlerini yalnızca HAZIRLAR. Bağlantı anahtarlarına ve şifrelere erişemez. Entegrasyonları görme iznini kapsar.
read_team	Ayrılmış — istenemez	—	Ekip üyelerinizi, rollerini ve işlem geçmişinizi (denetim kaydı) görebilir.
write_team	Ayrılmış — istenemez	read_team	Ekip üyesi davet etme, rol değiştirme ve çıkarma işlemlerini yalnızca HAZIRLAR; yetki vermek yalnızca sizin elinizdedir. Ekibi görme iznini kapsar.
read_domains	Ayrılmış — istenemez	—	Alan adlarınızı, DNS kayıtlarınızı ve alan adı satış kayıtlarınızı görebilir.
write_domains	Ayrılmış — istenemez	read_domains	Alan adı ve DNS değişikliklerini yalnızca HAZIRLAR; alan adı satın alma, yenileme, aktarma ve DNS yayını gibi mağazanızı erişilemez kılabilecek veya para harcatacak işlemleri siz yaparsınız. Alan adlarını görme iznini kapsar.
read_backups	Ayrılmış — istenemez	—	Yedeklerinizin listesini ve durumunu görebilir. Yedek dosyalarını indirmez.
write_backups	Ayrılmış — istenemez	read_backups	Yedek alma ve geri yükleme işlemlerini yalnızca HAZIRLAR; geri yükleme mağazanızın verisini değiştirdiği için yalnızca siz yapabilirsiniz. Yedekleri görme iznini kapsar.
read_marketing	Ayrılmış — istenemez	—	Web push bildirimlerinizi ve pazarlama kanallarınızın ayarlarını görebilir.
write_marketing	Ayrılmış — istenemez	read_marketing	Pazarlama ayarlarında değişiklik hazırlayabilir; ziyaretçilere bildirim gönderen işlemleri yalnızca HAZIRLAR. Pazarlama bilgilerini görme iznini kapsar.
write_payments	Ayrılmış — istenemez	read_payments	Ödeme yöntemi ayarlarında (havale, kapıda ödeme, taksit) değişiklik hazırlayabilir. Sağlayıcı anahtarlarına erişemez, tahsilat yapamaz, para iadesi veremez; geri alınamayan her ödeme işlemini yalnızca HAZIRLAR. Ödeme ayarlarını görme iznini kapsar.