MicroApp kurulumu

Ne işe yarar?

Uygulama mağazasından ek özellik modülü kurma.

Neden önemli?

Doğru izinlerle güvenli genişletilmiş iş akışı sağlar.

Detaylı açıklama

MicroApp’ler çekirdek veriye doğrudan erişmez; manifestte tanımlı izinlerle CoreApi üzerinden çalışır. Kurmadan önce scope listesini okuyun.

Uygulama mağazası (/appStore) manifest’ten katalog okur. Kurulum ve kaldırma ana mağaza sahibi veya panel admin içindir; CSRF korumalıdır. Kurulum istenen permissions[] listesini gösterir — onaylamadan çekirdek veriye erişmez. Çalışma zamanı /app/{handle} altındadır. Ana mağaza seçici (?mainStoreId=) yanlışsa uygulama boş/yanlış tenant görür.

Ön koşullar

• Uygulama mağazasına erişim ve kurulum yetkisi.
• İhtiyaç duyulan paket limiti.

Adımlar (Menü > Uygulama Mağazası)

1. İhtiyacınıza uygun uygulamayı bulun.
2. Kur ve istenen izinleri okuyup onaylayın.
3. Gerekirse mağaza bazında etkinleştirin.
4. /app/{handle} üzerinden çalıştığını test edin.
5. Doğru ana mağaza seçiliyken /appStore kataloğunu açın.
6. Uygulamayı bulun; izin listesini okuyup Kur’a basın.
7. /app/{handle} ile temel işlevi test edin.

Menüde görünmeme

Manifest ui.menu (tools, shipment, product…) ve showInMenu menüyü belirler. Kullanıcının varsayılan aksiyona izni yoksa sekme gizlenir. İzinler.

Sık karşılaşılan hatalar

• Kurulum tamamlanmıyor — Paket limiti veya yetki eksikliği olabilir; yöneticinizle kontrol edin.
• Kurulum tamamlanmıyor — Paket limiti veya yetki. Ana mağaza sahibi ile deneyin.
• Kurulu ama 403 — Kullanıcı izin matrisi. /appStore/permissions/{handle}.

Sık sorulan sorular

Kaldırınca veri silinir mi?

Uygulama kendi depolamasına bağlıdır. Kritik export’u kaldırmadan alın.

Public app nedir?

Bazı uygulamalar oturumsuz /app/{handle} açılır. Satış vitrini (commerce) tenant URL’si ayrıdır.

İlgili rehberler

• MicroApp izinleri
• Popüler MicroApp özetleri

Hâlâ çözülmedi?

• Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, ekran görüntüsü ve tam hata metnini ekleyin.
• WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
• Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.