Başlarken
1. Test mağazası
İş ortaklığı ve sözleşme adımları tamamlandığında Ideasoft App Store ekibi, geliştirme sırasında kullanmanız için magaza-adiniz.myideasoft.com biçiminde bir test mağazası tanımlar. Uygulamanızı bu mağazanın yönetim paneli ve API'si üzerinde geliştirip test edersiniz.
2. Test sürecinde API erişimi
Geliştirme sırasında test mağazanızın yönetim panelinde Entegrasyonlar → API → Ekle yolundan bir API kaydı oluşturursunuz:
- Redirect URL'yi siz girersiniz.
- Client ID ve Client Secret sistem tarafından üretilir.
- Uygulamanın erişeceği alanlar için okuma veya okuma/yazma izinlerini aynı ekrandan verirsiniz.
Bu kayıtla yetkilendirme ve token alma adımları Kimlik Doğrulama sayfasında anlatılır.
3. Yayındaki uygulama kaydı
App Store'da yayınlanan uygulamalarda yapı farklıdır:
- Client ID ve Client Secret Ideasoft tarafından verilir ve tüm mağazalar için sabittir; her mağaza için ayrı anahtar yoktur. Bu bilgiler test süreciniz tamamlandıktan sonra iletilir.
- Redirect URL ve Uninstall Hook URL adresleriniz bu kayda tanımlanır.
- Uygulamanın istediği izinler (okuma, okuma/yazma) uygulama kaydında tanımlanır ve kurulumda mağaza yöneticisine onay ekranında gösterilir.
- Mağaza yöneticisi panelde API kaydı oluşturmaz; yetkilendirme App Store kurulumunda Ideasoft'un sunduğu onay ekranıyla yapılır.
Client Secret'ı gizli tutun
Client Secret; token alma ve state, hmac, hash imzalarını doğrulama için kullanılır. Yalnızca sunucu tarafında saklayın; tarayıcıya, mobil uygulamaya, URL'lere veya log kayıtlarına koymayın.
4. Gerekli adresler
| Adres | Ne için | Gereksinimler |
|---|---|---|
| Redirect URL | Kurulumda ve her açılışta yöneticinin yönlendirildiği; state, code, domain ve user_id değerlerinin geldiği adres. | Yetkilendirme isteklerinde kayıtlı değerle birebir aynı gönderilmelidir. Gömülü uygulamalarda sorgu dizesi (?…) içermemelidir. |
| Uninstall Hook URL | Uygulama kaldırıldığında JSON bildiriminin gönderildiği adres. | POST kabul etmeli ve işlem başarılı olduğunda HTTP 200 dönmelidir. |
Her iki adres de Ideasoft'a özel olmalı ve HTTPS kullanmalıdır.
Hazırlık listesi
- Test mağazası tanımlandı ve yönetim paneline erişebiliyorsunuz.
- Test mağazasında API kaydı oluşturuldu ve token alabiliyorsunuz.
- Redirect URL,
statedoğrulamasıyla hazır (Kurulum ve Yetkilendirme). - Uninstall Hook URL,
hashdoğrulamasıyla hazır ve HTTP 200 dönüyor (Kaldırma). - Uygulamanız panel içinde çalışacaksa
hmacdoğrulaması hazır (Gömülü Uygulamalar).