Uygulamaların henüz yapamadıkları

Bu sayfa, bir sınırı üretimdeki bir olaydan değil buradan öğrenmeniz için var. Her madde platformun bugünkü durumuna dair bir olgudur, yarına dair bir söz değildir. Bir madde düzeltildiğinde bu sayfadan çıkar.

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

17istenebilir scope — hepsi uygulanıyor

2247platform API'sindeki toplam işlem

Uygulamalara açık olmayan alanlar

Yalnızca katalog, koleksiyonlar, stok seviyeleri, medya içe aktarma, metaobject’ler ve webhook abonelikleri uygulama token’larını kabul eder. Siparişler, müşteriler, fiyatlar, stok değişiklikleri, koleksiyon değişiklikleri, indirimler, kargo, temalar, SEO, analitik, formlar, yorumlar, sadakat, destek, çeviriler, medya veya metaobject okuma ya da uygulama verisi için uygulama API’si yoktur. Ürünler bir uygulama tarafından oluşturulamaz veya silinemez, yalnızca güncellenebilir.

Aşağıdaki scope’lar (yetkiler) ayrılmıştır: tanımlıdırlar, ancak bir endpoint onları uygulayana kadar verilemezler (birini istemek unpublished_scope ile reddedilir):

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.

Kimlik doğrulama

• Kendi kendine uygulama kaydı henüz yok. Authorization-code + PKCE kurulum akışı vardır (uygulamanız tüccarı mağazasındaki /apps/oauth/authorize adresine yönlendirir; tüccar yönetim panelinde onay verir; kodu POST /apps/token ile değiştirirsiniz, yenilemeyi refresh_token ile yaparsınız), ancak istemci kimlik bilgilerinin ve yönlendirme adreslerinin sahibi olan uygulama kaydını hâlâ mağaza ya da CIQRA oluşturur. Partner listeleri Partner API üzerinden gönderilir (bkz. partners.ciqra.com); listelenen bir uygulama henüz tüccarlar tarafından uygulama mağazasından kurulamaz.
• İmzalama secret’ını hiçbir endpoint üzerinden siz döndüremezsiniz (rotate edemezsiniz). CIQRA yalnızca ele geçirilmiş bir secret’ı emekliye ayırabilir.

Webhook’lar

• Tüm product.* ve tüm customer.* olaylarına abone olunabilir, ancak bunlar henüz hiç gönderilmiyor.
• Bir aboneliği güncelleyen endpoint yoktur; aboneliği değiştirin (yenisini oluşturup eskisini silin).

Henüz açılmamış platform servisleri

• Zamanlanmış tetikleyiciler. Platformda uygulamalar için bir zamanlayıcı var (cron, imzalı tetikleme çağrıları), ancak bir zamanlama tanımlamak için endpoint yok. Şimdilik kendi zamanlayıcınızı çalıştırın.
• Uygulama verisi depolama. Kurulum başına anahtar/değer depolama dahili olarak mevcut, ancak uygulama endpoint’i yok.
• Kaldırma (uninstall) token’ları iptal eder ve webhook aboneliklerini hemen kaldırır, ancak platformun uygulama için sakladığı verileri henüz silmez.

Referans uygulama

• Zugo, yayımlanabilir bir türün kayıtlarını yazarken publishedAt göndermez; bu da kayıtları yayımlanmamış olarak saklar. Bkz. örnek.