What apps cannot do yet
This page exists so that you learn about a limit here rather than from a production incident. Each item is a fact about the platform today, not a promise about tomorrow. When one is fixed it leaves this page.
Areas not open to apps
Section titled “Areas not open to apps”Only the catalogue, collections, inventory levels, media imports and uploads, blog posts and categories, metaobjects and webhook subscriptions accept app tokens. There is no app API for orders, customers, prices, stock changes, collection changes, discounts, shipping, themes, SEO, analytics, forms, reviews, loyalty, support, translations, reading media or metaobjects, or app data. Products cannot be created or deleted by an app, only updated.
These scopes are reserved: defined, but not grantable until an endpoint enforces them (requesting one is
refused with unpublished_scope):
| Scope | Status | Also grants | What the merchant is told |
|---|---|---|---|
write_collections | Reserved — not grantable | 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 | Reserved — not grantable | 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 | Reserved — not grantable | — | Ürün fiyatlarınızı, indirimli fiyatları ve fiyat listelerini görebilir. |
write_prices | Reserved — not grantable | 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 | Reserved — not grantable | — | Henüz siparişe dönüşmemiş teklif ve taslak siparişleri görebilir. |
write_draft_orders | Reserved — not grantable | read_draft_orders | Taslak sipariş ve teklif hazırlayabilir, içeriğini değiştirebilir. Taslakları görme iznini kapsar. |
read_fulfillments | Reserved — not grantable | — | Siparişlerin hangi kargoyla, ne zaman gönderildiğini ve takip numaralarını görebilir. |
write_fulfillments | Reserved — not grantable | read_fulfillments | Siparişleri gönderildi olarak işaretleyebilir, kargo ve takip bilgisi girebilir. Gönderileri görme iznini kapsar. |
read_returns | Reserved — not grantable | — | İade taleplerini, sebeplerini ve durumlarını görebilir. |
write_returns | Reserved — not grantable | 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 | Reserved — not grantable | 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 | Reserved — not grantable | 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 | Reserved — not grantable | — | İçeriğinizin diğer dillerdeki çevirilerini görebilir. |
write_translations | Reserved — not grantable | read_translations | Çevirileri değiştirebilir — yani bir dilde mağazanızın ne yazdığını belirleyebilir. Çevirileri görme iznini kapsar. |
read_media | Reserved — not grantable | — | Görsellerinizi, videolarınızı ve yüklediğiniz dosyaları görebilir. |
read_discounts | Reserved — not grantable | — | Kupon ve indirim kurallarınızı görebilir. |
write_discounts | Reserved — not grantable | 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 | Reserved — not grantable | — | Kargo yöntemlerinizi, teslimat bölgelerinizi ve ücretlerinizi görebilir. |
write_shipping | Reserved — not grantable | 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 | Reserved — not grantable | — | Ö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 | Reserved — not grantable | read_forms | Form oluşturabilir ve alanlarını değiştirebilir. Formları görme iznini kapsar. |
read_support | Reserved — not grantable | — | Destek taleplerini ve yazışmalarını görebilir. |
write_support | Reserved — not grantable | read_support | Destek talebi açabilir, durumunu değiştirebilir ve talebe not düşebilir. Destek taleplerini görme iznini kapsar. |
read_loyalty | Reserved — not grantable | — | Sadakat programınızı, puanları ve üyelik seviyelerini görebilir. |
write_loyalty | Reserved — not grantable | 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 | Reserved — not grantable | — | Ürün değerlendirmelerini ve puanlarını görebilir. |
write_reviews | Reserved — not grantable | 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 | Reserved — not grantable | — | Temanızı ve tema dosyalarınızı görebilir. |
write_themes | Reserved — not grantable | 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 | Reserved — not grantable | — | 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 | Reserved — not grantable | — | Arama motoru başlıklarınızı, açıklamalarınızı ve yönlendirmelerinizi görebilir. |
write_seo | Reserved — not grantable | 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 | Reserved — not grantable | — | 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 | Reserved — not grantable | — | Yalnızca kendi sakladığı ayar ve verileri okuyabilir. Mağazanızın verilerine erişmez. |
write_app_data | Reserved — not grantable | 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 | Reserved — not grantable | — | Mağaza ayarlarınızı (diller, bildirimler, e-posta şablonları, yasal metinler, çerez ve güvenlik ayarları) görebilir. |
write_settings | Reserved — not grantable | 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 | Reserved — not grantable | — | Yapay zekâ ayarlarınızı, kullanımınızı ve kredi bakiyenizi görebilir. |
write_ai | Reserved — not grantable | 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 | Reserved — not grantable | — | Planınızı, faturalarınızı ve kullanım bilgilerinizi görebilir. |
write_billing | Reserved — not grantable | 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 | Reserved — not grantable | — | 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 | Reserved — not grantable | 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 | Reserved — not grantable | — | Ekip üyelerinizi, rollerini ve işlem geçmişinizi (denetim kaydı) görebilir. |
write_team | Reserved — not grantable | 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 | Reserved — not grantable | — | Alan adlarınızı, DNS kayıtlarınızı ve alan adı satış kayıtlarınızı görebilir. |
write_domains | Reserved — not grantable | 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 | Reserved — not grantable | — | Yedeklerinizin listesini ve durumunu görebilir. Yedek dosyalarını indirmez. |
write_backups | Reserved — not grantable | 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 | Reserved — not grantable | — | Web push bildirimlerinizi ve pazarlama kanallarınızın ayarlarını görebilir. |
write_marketing | Reserved — not grantable | 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 | Reserved — not grantable | 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. |
Authentication
Section titled “Authentication”- No self-serve app registration yet. The authorization-code + PKCE install flow exists (your app sends the
merchant to
/apps/oauth/authorizeon their store; they consent in the admin; you exchange the code atPOST /apps/token, and refresh withrefresh_token), but the app record that owns the client credentials and redirect URIs is still created by the store or by CIQRA. Partner listings are submitted through the Partner API (see partners.ciqra.com), and a listed app is not yet installable by merchants from the app market. - You cannot rotate the signing secret through any route. CIQRA can only retire a compromised one.
Webhooks
Section titled “Webhooks”- All
product.*and allcustomer.*events can be subscribed to but are never sent yet. - There is no route to update a subscription; replace it.
Platform services not yet exposed
Section titled “Platform services not yet exposed”- Scheduled triggers. The platform has a scheduler for apps (cron, signed trigger calls) but no route to declare a schedule. Run your own scheduler for now.
- App data storage. Per-installation key/value storage exists internally but has no app route.
- Uninstall revokes tokens and removes webhook subscriptions immediately, but does not yet delete data the platform stored for the app.
Reference app
Section titled “Reference app”- Zugo omits
publishedAtwhen writing entries of a publishable type, which stores them unpublished. See the example.