Gömülü Uygulamalar
Gömülü olarak tanımlanan uygulamalar, mağaza panelindeki uygulama sayfasında bir çerçeve (iframe) içinde açılır. Panel bu durumda yetkilendirme adresine değil, doğrudan Redirect URL'nize imzalı parametrelerle gider; uygulamanız mağazayı doğruladıktan sonra gerekirse kendi yetkilendirme isteğini başlatır.
- 1.Mağaza yöneticisi→Mağaza paneli
Uygulamalar sayfasında uygulama detayını açar
- 2.Mağaza paneli→Uygulamanız
Uygulamanızı çerçeve içinde açar
Redirect URL'nize
embedded,domain,date, varsarenew_datevehmacparametreleriyle. - 3.Uygulamanız
hmac ve date değerini doğrular
datebugün veya dün değilse adresi reddedin. - 4.Uygulamanız→Mağaza paneli
Oturum yoksa yetkilendirme ister
/panel/authadresine kendi ürettiğinizstateile. - 5.Mağaza paneli→Uygulamanız
code ile geri döner
Uygulama kurulu olduğu için izin ekranı gösterilmez.
- 6.Uygulamanız→Mağaza API
Yetki kodunu token ile değiştirir
POST /oauth/v2/token - 7.Uygulamanız→Mağaza yöneticisi
Arayüzünü panel içinde gösterir
Açılış adresi
Code
| Parametre | Açıklama |
|---|---|
embedded | Her zaman 1. |
domain | Mağazanın alan adı, şema olmadan (ör. magaza-adiniz.myideasoft.com). |
date | Adresin üretildiği gün, YYYYMMDD (Türkiye saati). |
renew_date | Yalnızca yıllık yenilemeli ürünlerde: yenileme tarihi, YYYYMMDD. |
hmac | Yukarıdaki parametrelerin HMAC-SHA256 imzası. |
Redirect URL sorgu dizesi içermemeli
Panel bu parametreleri Redirect URL'nizin sonuna ? ile ekler. Kayıtlı adresiniz zaten ? içeriyorsa açılış adresi bozulur.
hmac doğrulama
Code
- Metin, state doğrulamadaki gibi PHP
json_encodeçıktısıdır: anahtar sırası sabit, boşluk yok. embeddeddeğeri sayı değil,"1"metnidir.dateURL'de gelir; imzayı bu değerle hesaplayın, ardından tarihin bugün veya dün olduğunu kontrol edin. Daha eski adresleri reddedin.- Karşılaştırmayı sabit zamanlı yapın.
Test vektörü: client_secret=ornek-client-secret, domain=magaza-adiniz.myideasoft.com, date=20260518 (renew_date yok) için imzalanan metin {"embedded":"1","domain":"magaza-adiniz.myideasoft.com","date":"20260518"}, hmac değeri 8b4ac8621d8df8ee80a7af7a62c29671aae737a5e1ef1e199765126f3243ccff olur.
hmac oturum değildir
hmac yalnızca mağaza ve gün bilgisini imzalar; aynı gün içinde tekrar kullanılabilir. Bu yüzden onu kalıcı oturum veya API yetkisi olarak kullanmayın, log kayıtlarına yazmayın. Mağaza verisine erişmek için aşağıdaki yetkilendirmeyi tamamlayın.
Yetkilendirme
Bu mağaza için geçerli bir oturumunuz veya token'ınız yoksa, çerçeve içinden mağazanın yetkilendirme adresine kendi ürettiğiniz bir state ile yönlendirin:
Code
Uygulama mağazada zaten kurulu olduğu için onay ekranı gösterilmez; mağaza Redirect URL'nize state, code, domain ve user_id ile döner. Bu akışta state Ideasoft imzası değil, sizin gönderdiğiniz değerdir; sakladığınız değerle karşılaştırın. Ardından code ile token alın.
Çerçeve içinde çalışma
- Uygulamanız mağaza panelinin içinde çerçevede açılır. Çerçevelenmeyi engelleyen başlıklar (
X-Frame-Options,frame-ancestorsiçerenContent-Security-Policy) mağaza alan adlarının uygulamanızı göstermesine izin vermelidir. - Tarayıcılar çerçeve içindeki üçüncü taraf çerezleri kısıtlayabilir. Oturumunuzu yalnızca çereze bağlamayın; her açılışta
hmacdoğrulaması ve yetkilendirme akışıyla yeniden kurulabilecek şekilde tasarlayın.