Eski Kurulumdan Geçiş
Uygulamanız bugün kurulumda mağazada açılan bir web servis (rest1) kullanıcısıyla ve gateway.tsoftapps.com yönlendirmesiyle çalışıyorsa bu sayfa sizin için. Bu iki yol kapanacak; yerine OAuth kurulumu, 2026-01 Admin API'si ve panel içi açılış geliyor.
Ne neyle değişiyor
| Eski | Yeni |
|---|---|
Kurulumda prefix adıyla açılan rest1 kullanıcısı ve şifresi | Mağaza onayıyla gelen kurulum kodu, uygulama kimliği + store_id ile alınan token (OAuth Akışı) |
https://<mağaza>/rest1/* çağrıları | https://<mağaza>/api/v3/admin/2026-01/* (JSON:API) |
| Paketteki web servis metot listesi | Onay ekranında gösterilen kapsamlar |
| Kurulum anında sunucunuza yapılan kayıt çağrısı | Kurulum kodunun redirect_uri ya da app_url adresinize gelmesi |
| Kaldırırken sunucunuza yapılan çağrı | uninstall_url adresinize imzalı app.uninstalled bildirimi (Webhooks) |
gateway.tsoftapps.com/api/go/app/<prefix> ve /api/app/get-token/<prefix> yönlendirmesi, panel kartı | Panel içinde /apps/open/<prefix> iframe'i ve ES256 oturum token'ı (Panele Gömülü Uygulamalar) |
| Gateway lambda uçları | Admin API ve kendi sunucunuz |
Vitrine kod ekleyen uygulamalar için takip kodu modülü de değişiyor: kod, mağaza sahibinin kurulumda doldurduğu ayar formuyla eklenir. Hem vitrine kod ekleyen hem API'ye erişen uygulamalar tek kurulumda iki adımı birlikte alır: önce ayar formu, sonra izin onayı.
Mevcut mağazalarınız
Uygulamanızı eski yöntemle kurmuş mağazalar, kaydınıza kapsamlar eklendiğinde Uygulamalarım ekranında İzinleri onayla bağlantısını görür. Mağaza sahibi onayladığında kurulum kodu size gelir; o andan itibaren o mağazayı yeni yolla çalıştırabilirsiniz.
Geçiş süresince iki yolu birlikte çalıştırın: kurulum kodu gelmiş mağazada Admin API'yi, gelmemiş mağazada eski yolu kullanın.
Adımlar
Kapsamlarınızı çıkarın
Kullandığınız her web servis metodunun karşılığını Kapsamlar sayfasında bulun. Karşılığını bulamadığınız bir metot varsa bize bildirin.
Kaydınızı güncelletin
redirect_uri, panel içinde açılacaksa app_url, kaldırma bildirimi için uninstall_url ve kapsam listesini iletin; karşılığında uygulama sırrınızı alın.
Test mağazasında deneyin
Kurulum kodunu takas edin, token alın, Admin API'yi çağırın, uygulamanızı panel içinde açın ve kaldırma bildirimini doğrulayın.
Mevcut mağazaları taşıyın
Mağaza sahiplerini İzinleri onayla adımına yönlendirin. Eski yol kapanana kadar iki yolu birlikte çalıştırın.
Örnek bir uygulamanın kaynağını ve takvimi T-SOFT ekibinden isteyebilirsiniz.