---
title: Giriş
description: ikas uygulama ekosistemine hoş geldiniz!
---

ikas, yalnızca bir e-ticaret altyapısı değil; geliştiricilerin mağaza sahipleri için **yenilikçi çözümler üretebileceği** güçlü bir uygulama platformudur.
  
Bu platform, size **public GraphQL API** aracılığıyla ikas verilerine erişme, **Admin Uygulamaları** oluşturarak App Store'da yayınlama veya **Özel Uygulamalar** geliştirerek tekil müşterilerin ihtiyaçlarını çözme imkânı sunar.

Bu dokümantasyonda adım adım:  
- <DatabaseIcon className="inline size-5 text-fd-muted-foreground" /> **API verileri**: ürün, sipariş, müşteri ve envanter gibi verilerine erişim,  
- <WebhookIcon className="inline size-5 text-fd-muted-foreground" /> **Webhook'lar**: mağaza içi olaylara gerçek zamanlı abonelik,  
- <ButtonIcon className="inline size-5 text-fd-muted-foreground" /> **Actions**: Yönetim Paneline kendi aksiyonlarınızı ekleme,  
- <WindowIcon className="inline size-5 text-fd-muted-foreground" /> **App Bridge**: iFrame içinden güvenli dashboard iletişimi,  
- <TerminalIcon className="inline size-5 text-fd-muted-foreground" /> **CLI**: dakikalar içinde yeni bir uygulama başlatma.

---

## Uygulama Türleri

### Admin Uygulamaları (Public Apps)  

Geliştiriciler, **ikas Partners** üzerinden veya ikas CLI üzerinden Admin Uygulamasını oluşturabilir ve ikas App Store’da yayınlayabilir. ikas'ın Next.js projesi ile geliştirilmek zorundadır.  

Öne çıkan özellikler:  
- **Mağaza içi deneyim**: Uygulamanın arayüzü ikas Admin Paneli’nde içinde çalışır. Böylece kullanıcı ikas’tan çıkmadan uygulamanızın tüm özelliklerini deneyimler.  
- **App Store satışı**: Uygulamalarınızı ücretli veya ücretsiz yayınlayabilir, deneme süreleri tanımlayabilir ve gelir elde edebilirsiniz.  
- **Actions & App Bridge**: Yönetim paneline özel butonlar ekleyebilir, kullanıcıyla doğrudan etkileşime geçebilirsiniz.  
- **Standart OAuth2 Authorization Code Flow**: Mağaza sahibinin izniyle güvenli veri erişimi sağlar.  

<Callout type="info" title="Uygulama Mağazası Bilgilendirme">
ikas uygulama mağazasında yayınladığınız uygulamalar, kullanıcılar tarafından doğrudan ikas üzerinden satın alınır. Her satış sonrası hakedişiniz sistemimize yansır ve belirli dönemlerde tarafınıza ödenir. Böylece siz yalnızca uygulamanızı geliştirmeye odaklanır, satış ve tahsilat süreçlerini ikas'a bırakırsınız. 

Bu dökümanda şu anda sadece uygulama geliştirme kısımları yer almaktadır, kısa zaman içerisinde lisanslarınızı nasıl yöneteceğinize dair dökümanlar eklenecektir.
</Callout>

<Callout type="info" title="İlk Geliştiricilere Özel Fırsatlar! 🎉">

Uygulama mağazamızda ilk yayınlanan uygulamalar için özel fırsatlar sizi bekliyor!	

 - Belirli süre boyunca ek hakediş 	    
 - Özel promosyon ve görünürlük desteği
 - Kampanyalara katılımda öncelik

Sen de hemen uygulamanı geliştir, mağazamızda yayınla ve bu ayrıcalıklardan faydalan!
</Callout>


---

### Özel Uygulamalar (Private Apps)  

**Özel Uygulamalar**, mağazalara özel entegrasyonlar geliştirmek için idealdir. Partners hesabı oluşturmaya gerek yoktur, mağazadan alınacak client_id ve client_secret ile geliştirilmeye başlanabilir.

Öne çıkan özellikler:  
- **Tek mağazaya özel**: Başka mağazalar tarafından kullanılamaz.  
- **OAuth2 Client Credentials Flow**: Mağaza sahibi doğrudan client_id ve client_secret alarak uygulamanın kimliğini doğrular.  
- **Arayüzsüz**: iFrame veya App Bridge desteği bulunmaz. Yalnızca API üzerinden çalışır.  
- **Basit kurulum**: Mağaza yöneticisi birkaç adımda kendi özel entegrasyonunu devreye alabilir.  

---

## Karşılaştırma Tablosu  

| Özellik               | Mağaza Uygulamaları | Özel Uygulamalar |
|------------------------|----------------------|------------------|
| Yayınlama              | App Store Üzerinden  | Mağaza Spesifik |
| Yetkilendirme          | OAuth2 Auth Code Flow| OAuth2 Client Credentials |
| iframe render          | ✅                   | ❌               |
| App Bridge             | ✅                   | ❌               |
| Actions                | ✅                   | ❌               |
| Webhook’lar            | ✅                   | ✅               |
| API uçları             | Aynı                 | Aynı             |


---

<Callout type="info" title="Admin Uygulama: Hızlı Başlangıç">
App Store'da yayınlanabilir yönetim uygulaması geliştirmeye başlamak için rehbere göz atın: [Admin App Quick Start](/docs/app-development/admin-app-quick-start)
</Callout>

<Callout type="info" title="Özel Uygulama (Private App): Hızlı Başlangıç">
Tek mağazaya özel entegrasyonunuzu hızla devreye almak için adımları izleyin: [Private App Quick Start](/docs/app-development/private-app-quick-start)
</Callout>

---

## Öne Çıkan Araçlar  

ikas ekosisteminde başarılı bir uygulama geliştirmek için elinizin altında dört temel araç bulunur:  

- **ikas CLI**: <TerminalIcon className="inline size-5 align-[-0.2em] text-fd-muted-foreground" />  
  Saniyeler içinde yeni bir proje başlatın, geliştirme ortamınızı ayağa kaldırın ve uygulamanızı publish edin.  

- **ikas SDK (TypeScript)**: <CodeIcon className="inline size-5 align-[-0.2em] text-fd-muted-foreground" />  
  GraphQL API çağrılarını daha güvenli, tip destekli ve kolay okunur hale getirir.  

- **ikas App Bridge**: <WindowIcon className="inline size-5 align-[-0.2em] text-fd-muted-foreground" />  
  iframe içindeki uygulamanız ile Admin Panel arasında güvenli iletişim kurar.  

- **Actions**: <ButtonIcon className="inline size-5 align-[-0.2em] text-fd-muted-foreground" />  
  Yönetim Paneline özel butonlar ekleyerek kullanıcıların günlük işlerini hızlandırın.