# Genel Bakış

Ideasoft App Store ([apps.ideasoft.com.tr](https://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](/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:

<FlowGrid>
  <Flow title="App Store'dan kurulum" path="merchant | Yükle veya Uygulamaya Git | appstore | Yetkilendirme sayfası | panel | code + state | app" href="/app-store/installation">
    İlk kurulumda ve App Store'dan yapılan sonraki açılışlarda.
  </Flow>
  <Flow title="Panelden açma" path="merchant | Uygulamalar listesi | panel | code + state | app" href="/app-store/installation">
    Yönetici uygulamayı mağaza panelindeki **Uygulamalar** sayfasından açtığında.
  </Flow>
  <Flow title="Gömülü uygulama" path="merchant | Uygulama detayı | panel | iframe + hmac | app" href="/app-store/embedded-apps">
    Uygulamanız panel içinde çalışacak şekilde tanımlandıysa.
  </Flow>
</FlowGrid>

## 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`). |

:::info{title="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ı

1. [Başlarken](/app-store/getting-started): test mağazası, uygulama kaydı ve gerekli adresler.
2. [Kurulum ve Yetkilendirme](/app-store/installation): yönlendirmeyi doğrulayıp token alma.
3. [Gömülü Uygulamalar](/app-store/embedded-apps): uygulamanız panel içinde çalışacaksa.
4. [Kaldırma](/app-store/uninstall): uninstall hook'u işleme.
5. [Yayın Süreci](/app-store/publishing): test, inceleme, içerikler ve canlıya alım.
