Başlangıç

İ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 ü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ı.

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ı.

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.

Bu sayfa .md olarak: /docs/baslangic.md