# Başlangıç

> İlk isteğinizi 3 adımda atın. İki yol var: kendi ürününüzü kuran geliştirici için Platform API, kendi kafesinin verisini okuyan işletme için İşletme API.

İki farklı yolculuk var. Hangisi sizinki?

- **Kendi ürünümü kuruyorum** (uygulama, ajans paneli, SaaS): Platform API ile devam edin, bu sayfanın ilk yarısı sizin.
- **Kendi kafemin verisini okuyacağım** (rapor, entegrasyon, otomasyon): İşletme API ile devam edin, ikinci yarı sizin.

## Yol 1: Platform API ile kendi ürününüz

### 1. Kaydolun ve anahtarınızı alın

[app.sadakio.com/gelistirici/kayit](https://app.sadakio.com/gelistirici/kayit) üzerinden kaydolun. Şirket gerekmez, insan onayı beklemezsiniz. Kayıt sırasında ilk işletmeniz de açılır, yani ilk çağrınız prova değil gerçektir. `pk_` anahtarınız bir kez gösterilir, güvenli bir yere kaydedin.

### 2. İşletmelerinizi listeleyin

```
curl https://api.sadakio.com/platform/v1/businesses \
  -H "Authorization: Bearer pk_ANAHTARINIZ"
```

Yanıtta kayıtta açılan işletmenizi, `join_url` alanında da misafirlerinizin kayıt sayfasını görürsünüz.

### 3. Misafir kaydedin ve damga verin

```
curl -X POST https://api.sadakio.com/platform/v1/businesses/IS_ID/guests \
  -H "Authorization: Bearer pk_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+905551112233", "name": "Elif"}'

curl -X POST https://api.sadakio.com/platform/v1/businesses/IS_ID/guests/MISAFIR_ID/adjust \
  -H "Authorization: Bearer pk_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ilk-damga-1" \
  -d '{"counter": "damga", "delta": 1}'
```

Bu kadar. Misafir kayıtlı, damgası işlendi, aynı isteği tekrar gönderirseniz `replayed: true` ile aynı sonuç döner ve hiçbir şey iki kez işlenmez. Devamı için [Platform API referansı](/docs/platform).

## Yol 2: İşletme API ile kendi verinize erişim

### 1. Anahtarınızı panelden alın

Sadakio hesabınızda **Ayarlar → API** bölümüne girin ve `sk_` anahtarınızı oluşturun. Ham anahtar yalnızca bir kez gösterilir.

### 2. Misafir listenizi çekin

```
curl https://api.sadakio.com/api/v1/guests \
  -H "Authorization: Bearer sk_ANAHTARINIZ"
```

Telefonlar KVKK gereği maskeli döner, veriler yalnızca sizin işletmenize aittir.

### 3. Geri dönüş özetini alın

```
curl "https://api.sadakio.com/api/v1/stats/retention?period=month" \
  -H "Authorization: Bearer sk_ANAHTARINIZ"
```

Devamı için [İşletme API referansı](/docs/api).

## Ajanınıza bırakın

Cursor, Claude veya ChatGPT kullanıyorsanız şu promptu yapıştırın:

```
Sadakio üzerinde bir entegrasyon kur.
Dokümanların tamamı: https://sadakio.com/llms-full.txt
Platform kontratı: https://api.sadakio.com/platform/v1/openapi.yaml
İşletme kontratı: https://api.sadakio.com/api/v1/openapi.yaml
Anahtarım hazır. Bana [kurmak istediğiniz şeyi yazın] yap.
```