Kurulum ve Yetkilendirme
Mağaza yöneticisi uygulamanızı App Store'dan kurduğunda, App Store'da Uygulamaya Git butonuna bastığında veya mağaza panelindeki Uygulamalar listesinden açtığında aynı akış çalışır:
- 1.Mağaza yöneticisi→App Store
Uygulamayı yükler veya satın alır
Ücretli uygulamalarda önce ödeme alınır.
- 2.App Store→Mağaza paneli
Mağazanın yetkilendirme sayfasına yönlendirir
https://<mağaza>/panel/authadresineclient_id,redirect_urive Ideasoft'un imzaladığıstateile. - 3.Mağaza paneli→Mağaza yöneticisi
İzin ekranını gösterir
Yalnızca ilk kurulumda. Uygulama daha önce onaylandıysa bu adım atlanır.
- 4.Mağaza yöneticisi→Mağaza paneli
İzinleri onaylar
- 5.Mağaza paneli→Uygulamanız
Redirect URL'nize yönlendirir
state,code,domain,user_idve varsarenew_dateparametreleriyle. - 6.Uygulamanız
State imzasını doğrular
Doğrulama başarısızsa akışı durdurun; token isteği yapmayın.
- 7.Uygulamanız→Mağaza API
Yetki kodunu token ile değiştirir
POST /oauth/v2/token,codealındıktan sonraki 30 saniye içinde. - 8.Mağaza API→Uygulamanız
Token'ları döner
access_token24 saat geçerlidir; süresi dolmadanrefresh_tokenile yenilenir. - 9.Uygulamanız→Mağaza API
Admin API'yi çağırır
Authorization: Bearer <access_token>başlığıyla.
Sonraki açılışlarda aynı akış çalışır: izin ekranı atlanır ve her seferinde yeni bir code gelir.
Redirect URL'ye gelen parametreler
Code
| Parametre | Açıklama |
|---|---|
state | 64 karakterlik onaltılık HMAC-SHA256 imzası. İsteğin Ideasoft'tan geldiğini doğrulamak için kullanılır (aşağıda). |
code | Token almak için kullanılan tek kullanımlık yetki kodu. 30 saniye geçerlidir. |
domain | Uygulamayı kuran veya açan mağazanın şemayla birlikte adresi, ör. https://magaza-adiniz.myideasoft.com. URL kodlu gelir. |
user_id | İşlemi yapan panel kullanıcısının kimliği. İmzaya dahil değildir. |
renew_date | Yalnızca yıllık yenilemeli ürünlerde: yenileme tarihi, YYYYMMDD (Yenileme tarihi). |
Yönetici izin vermeyi reddederse yönlendirme code yerine hata parametreleriyle gelir:
Code
State doğrulama
state, mağaza adresi ve tarihten oluşan bir JSON metninin Client Secret ile alınmış HMAC-SHA256 imzasıdır:
Code
İmzalanan metin PHP'nin json_encode çıktısıdır. Kendi dilinizde aynı metni üretirken şunlara dikkat edin:
- Anahtar sırası sabittir:
domain,date,renew_date. - Metinde boşluk yoktur.
/karakteri\/olarak yazılır:"https:\/\/magaza-adiniz.myideasoft.com". JavaScript'inJSON.stringifyve Python'unjson.dumpsfonksiyonları bunu yapmaz; aşağıdaki örneklerdeki yardımcı fonksiyonu kullanın.date, imzanın üretildiği gündür (Türkiye saati). URL'de gönderilmez; gece yarısı geçişleri için bugünü ve dünü deneyin.renew_dateyalnızca URL'de geldiyse metne eklenir.- Karşılaştırmayı sabit zamanlı yapın (
hash_equals,timingSafeEqual,compare_digest).
state doğrulanmadan token isteği yapmayın.
Test vektörü
Kendi uygulamanızı aşağıdaki değerlerle sınayabilirsiniz:
| Girdi | Değer |
|---|---|
client_secret | ornek-client-secret |
domain | https://magaza-adiniz.myideasoft.com |
date | 20260518 |
| İmzalanan metin | {"domain":"https:\/\/magaza-adiniz.myideasoft.com","date":"20260518"} |
state | ceae612ec90a5cdc06f4fede3dbdf2a1390acd9129812ea4c4ba77d6ff0ad835 |
renew_date=20270401 ile state | b575af08b8334a9434cbc3668b131036dc7f2590c396008c116b6ee83fb9583b |
Token alma
state doğrulandıktan sonra code değerini 30 saniye içinde token ile değiştirin. İstek, domain parametresinde gelen mağazaya yapılır:
Code
Yanıtta gelen access_token 24 saat geçerlidir. Süresi dolmadan refresh_token ile yenileyin; her yenilemede refresh token da değişir. İstek ve yanıt ayrıntıları, hata kodları ve yenileme isteği için Kimlik Doğrulama sayfasına bakın.
client_secret değerini istek gövdesinde gönderin; URL'de taşımayın.
Mağazayı ve kullanıcıyı tanıma
- Mağazayı
domainparametresiyle tanıyın.domain,stateimzasına dahil olduğu için doğrulama sonrasında güvenilirdir. Token'larınızı mağaza bazında saklayın. user_idimzaya dahil değildir; tek başına kimlik veya yetki kanıtı olarak kullanmayın.- Her açılışta yeni bir
codegelir. Mağaza için geçerli token'ınız varsa yeni token almak zorunda değilsiniz, ancakstatedoğrulamasını her açılışta yapın.
Yenileme tarihi (renew_date)
App Store'da yıllık yenilemeli olarak satılan ürünlerde yenileme tarihi Redirect URL'ye renew_date parametresiyle YYYYMMDD biçiminde eklenir (ör. renew_date=20270401). renew_date geldiğinde state imzasına da dahildir.
İlk kurulumda gelmeyebilir
Uygulama App Store üzerinden ilk kurulduğunda yenileme tarihi henüz oluşmamış olabilir; bu durumda renew_date gönderilmez. Tarih, kullanıcının uygulamaya sonraki girişlerinde gönderilir.