Genel Bakış
Ideasoft App Store (apps.ideasoft.com.tr), mağaza sahiplerinin uygulamaları ve entegrasyonları keşfedip mağazalarına kurduğu uygulama mağazasıdır. Bir App Store uygulaması, kendi sunucunuzda çalışan ve mağaza verisine Admin API üzerinden OAuth 2.0 ile erişen bir web uygulamasıdır.
Bu bölüm; uygulamanızın App Store'a nasıl bağlandığını, kurulum ve her açılışta size hangi bilgilerin iletildiğini, bu bilgileri nasıl doğrulayacağınızı ve uygulamanızın yayına nasıl alındığını anlatır.
Uygulamanız nasıl açılır?
Mağaza yöneticisi uygulamanıza üç yoldan ulaşır:
App Store'dan kurulum
İlk kurulumda ve App Store'dan yapılan sonraki açılışlarda.
- Mağaza yöneticisi
- Yükle veya Uygulamaya Git
- App Store
- Yetkilendirme sayfası
- Mağaza paneli
- code + state
- Uygulamanız
Panelden açma
Yönetici uygulamayı mağaza panelindeki Uygulamalar sayfasından açtığında.
- Mağaza yöneticisi
- Uygulamalar listesi
- Mağaza paneli
- code + state
- Uygulamanız
Gömülü uygulama
Uygulamanız panel içinde çalışacak şekilde tanımlandıysa.
- Mağaza yöneticisi
- Uygulama detayı
- Mağaza paneli
- iframe + hmac
- Uygulamanız
Temel kavramlar
| Kavram | Açıklama |
|---|---|
| Client ID / Client Secret | Yayındaki uygulamanız için Ideasoft'un verdiği sabit kimlik bilgileri. Tüm mağazalar aynı kimlikle yetkilendirilir; mağazaların ayrıca API anahtarı oluşturması gerekmez. |
| Redirect URL | Kurulumda ve her açılışta yöneticinin yönlendirildiği; code ve state değerlerinin geldiği adres. |
| Uninstall Hook URL | Uygulama kaldırıldığında App Store'un bildirim gönderdiği adres. |
state / hmac / hash | İsteğin gerçekten Ideasoft'tan geldiğini Client Secret ile doğrulamanızı sağlayan HMAC-SHA256 imzaları. |
renew_date | Yıllık yenilemeli ürünlerde yenileme tarihi (YYYYMMDD). |
Erişim App Store üzerinden
Mağaza yöneticilerinin uygulamanıza erişimi App Store'daki Uygulamaya Git butonu veya mağaza panelindeki Uygulamalar sayfası üzerinden olmalıdır. Mağazayı ve yetkiyi bu akışlarda gelen imzalı parametrelerle doğrulayın.
Geliştirme adımları
- Başlarken: test mağazası, uygulama kaydı ve gerekli adresler.
- Kurulum ve Yetkilendirme: yönlendirmeyi doğrulayıp token alma.
- Gömülü Uygulamalar: uygulamanız panel içinde çalışacaksa.
- Kaldırma: uninstall hook'u işleme.
- Yayın Süreci: test, inceleme, içerikler ve canlıya alım.