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.

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

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

999platform 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) şimdiden verilebilir, ancak hiçbir şeye erişim sağlamazlar:

Scope	Durum	Ayrıca verir	Tüccara gösterilen açıklama
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.
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.
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.
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.
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_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.

Kimlik doğrulama

• Token yanıtının anahtarları camelCase’dir (accessToken, expiresIn) ve token hataları errorDescription kullanır — RFC 6749’daki access_token / error_description biçimi değil. Standart OAuth istemci kütüphaneleri bunları ayrıştıramaz; JSON’u kendiniz okuyun.
• 401 ve 403 yanıtlarının gövdesi boştur. Platform henüz nedenini (süresi dolmuş, kaldırılmış, mağaza pasif, hangi scope eksik) söylemiyor. Bunları durum koduna göre ele alın.
• Authorization-code akışı yok. Üçüncü taraf uygulamalar için “bağlantıdan kur” onay ekranı yoktur; uygulamalar mağaza ya da CIQRA tarafından oluşturulur.
• İmzalama secret’ı hiçbir endpoint üzerinden döndürülemez (rotate edilemez).

Rate limit

• Kurulum başına kova (40 burst, 2/sn) her uygulama endpoint’ine bağlıdır; ancak isteklerin tanımlanma biçimi nedeniyle üretimde devreye girmeyebilir. Sizi kendi hatalarınızdan koruması için ona güvenmeyin.

Webhook’lar

• order.created, order.fulfilled, 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.