# 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](/getting-started/authentication) 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.

:::warning{title="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, `state` doğrulamasıyla hazır ([Kurulum ve Yetkilendirme](/app-store/installation)).
- Uninstall Hook URL, `hash` doğrulamasıyla hazır ve HTTP 200 dönüyor ([Kaldırma](/app-store/uninstall)).
- Uygulamanız panel içinde çalışacaksa `hmac` doğrulaması hazır ([Gömülü Uygulamalar](/app-store/embedded-apps)).
