> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Geliştiriciler

> OneSignal'ı entegre etmek için geliştirici kılavuzu: SDK kurulumu, API referansı, kullanıcı kimliği ve mobil ile web genelinde test.

Bu kılavuz, geliştiricilerin OneSignal'ı mobil ve web uygulamalarına entegre etmesine yardımcı olur. İlk kurulum için bölümleri sırayla takip edin veya ihtiyaç duyduğunuz alana doğrudan gidin.

1. [**Başlarken**](#get-started) — OneSignal Uygulamanıza erişin ve API anahtarlarınızı bulun
2. [**Mesajlaşma kanallarını ayarlayın**](#set-up-messaging-channels) — SDK'yı yükleyin ve kanalları yapılandırın
3. [**SDK ve API referansı**](#sdk-and-api-reference) — ayrıntılı yöntem, sınıf ve endpoint belgeleri
4. [**Kullanıcılar ve kimlik**](#users-and-identity) — Kullanıcıları tanımlayın, Abonelikleri yönetin ve erişimi güvenli hale getirin
5. [**Eğitimler**](#tutorials) — yaygın kullanım senaryoları için adım adım kılavuzlar
6. [**Test ve hata ayıklama**](#testing-and-debugging) — yayına geçmeden önce entegrasyonunuzu doğrulayın
7. [**Analitik ve webhook'lar**](#analytics-and-webhooks) — performansı izleyin ve sunucu tarafında mesaj olaylarını alın

***

## Başlarken

Ekibinizin zaten bir OneSignal hesabı varsa, bir yöneticiden sizi Organizasyon'a [davet etmesini](./manage-team-members) isteyin. Aksi takdirde, başlamak için [hesap oluşturun](https://onesignal.com).

OneSignal Uygulamanız, kullanıcı ve mesaj verilerinin bulunduğu yerdir. Her Uygulamanın kendi App ID'si, API anahtarları ve mesajlaşma kanalları vardır. Farklı projeler veya ortamlar için tek bir Organizasyon'da birden fazla Uygulama oluşturabilirsiniz.

<Columns cols={2}>
  <Card title="Uygulamalar, Organizasyonlar ve hesaplar" icon="building" href="./apps-organizations">
    Uygulamalar, Organizasyonlar ve hesapların birbirleriyle ilişkisi.
  </Card>

  <Card title="Anahtarlar ve ID'ler" icon="key" href="./keys-and-ids">
    Kimlik doğrulama için App ID, REST API anahtarı ve Organization ID'nizi bulun.
  </Card>

  <Card title="Ekip üyeleri ekleyin" icon="user-plus" href="./manage-team-members">
    Geliştiricileri davet edin ve Organizasyonunuzda roller atayın.
  </Card>

  <Card title="Kullanım ve Faturalama" icon="credit-card" href="./billing-faq">
    Faturalama, faturalar ve kullanım ayrıntıları.
  </Card>
</Columns>

***

## Mesajlaşma kanallarını ayarlayın

Platformlarınızda kullanıcı etkileşimini oluşturmak ve takip etmek için OneSignal SDK'yı yükleyin. Her mesaj kanalının kimlik bilgilerini, SDK başlatmayı ve öğreticileri kapsayan kendi kurulum kılavuzu vardır.

<Columns cols={3}>
  <Card title="Mobil SDK kurulumu" icon="mobile" href="./mobile-sdk-setup">
    iOS, Android, Huawei ve Amazon için SDK kurulumu. Push bildirimleri, uygulama içi mesajlar ve Canlı Aktiviteler'i etkinleştirir.
  </Card>

  <Card title="Web push" icon="globe" href="./web-sdk-setup">
    Web SDK kurulumu ve tarayıcı push bildirimi yapılandırması.
  </Card>

  <Card title="E-posta" icon="envelope" href="./email-setup">
    E-posta kanalı yapılandırması ve gönderici alan adı doğrulaması.
  </Card>

  <Card title="Uygulama içi mesajlar" icon="window-maximize" href="./in-app-messages-setup">
    Mobil uygulamanızda zengin, etkileşimli mesajlar görüntüleyin.
  </Card>

  <Card title="SMS" icon="comment-sms" href="./sms-messaging">
    SMS kanalı kurulumu ve operatör kaydı.
  </Card>

  <Card title="RCS" icon="message" href="./rcs-messaging">
    Marka içeriği ve okundu bilgisi ile zengin mesajlaşma.
  </Card>

  <Card title="Canlı Aktiviteler" icon="tower-broadcast" href="./live-activities">
    iOS dinamik kilit ekranı güncellemeleri. Android için de benzer özellikler mevcut.
  </Card>
</Columns>

***

## SDK ve API referansı

İstemci SDK'ları, sunucu SDK'ları ve REST API için ayrıntılı belgeler.

<Columns cols={2}>
  <Card title="Mobil SDK referansı" icon="mobile" href="./mobile-sdk-reference">
    iOS, Android ve çapraz platform SDK'ları için yöntemler, sınıflar ve olay hook'ları.
  </Card>

  <Card title="Web SDK referansı" icon="globe" href="./web-sdk-reference">
    Başlatma, Kullanıcı yönetimi, Abonelik yöntemleri ve özel tetikleyiciler.
  </Card>

  <Card title="Sunucu SDK referansı" icon="server" href="./server-sdk-reference">
    Node.js, Python, Java, Go, PHP, Ruby, C# ve Rust için sunucu SDK'larını yükleyin ve yapılandırın.
  </Card>

  <Card title="REST API genel bakış" icon="code" href="/reference/rest-api-overview">
    Endpoint'ler, kimlik doğrulama, hız sınırları ve istek/yanıt biçimleri.
  </Card>

  <Card title="İşlemsel mesajlar" icon="paper-plane" href="./transactional-messages">
    Kişiselleştirilmiş verilerle API aracılığıyla OTP, makbuz ve zamana duyarlı uyarılar gönderin.
  </Card>

  <Card title="GitHub'daki sunucu SDK'ları" icon="github" href="https://github.com/OneSignal/sdks#server-sdks">
    Tüm sunucu SDK kütüphaneleri için kaynak kod ve örnekler.
  </Card>
</Columns>

***

## Kullanıcılar ve kimlik

OneSignal her kişiye bir **OneSignal ID** atar ve cihazlarını, e-posta adreslerini ve telefon numaralarını **Abonelik** olarak takip eder. Kullanıcılar, onları tanımlamak için bir **External ID** ile `login` çağrılana kadar anonimdir. Kullanıcıları tanımlamak, Aboneliklerini kanallar ve cihazlar genelinde birleştirir.

<Columns cols={2}>
  <Card title="Kullanıcılar" icon="users" href="./users">
    Kullanıcı modeli, External ID, anonim ve tanımlanmış Kullanıcılar, giriş/çıkış.
  </Card>

  <Card title="Abonelikler" icon="address-book" href="./subscriptions">
    Mesajlarınızı alan cihazlar, e-posta adresleri ve telefon numaraları.
  </Card>

  <Card title="Kimlik doğrulama" icon="shield-halved" href="./identity-verification">
    Kullanıcı kimlik sahtekarlığını önlemek için sunucu tarafından oluşturulan JWT'ler gerektirir.
  </Card>

  <Card title="Takma adlar" icon="fingerprint" href="./aliases">
    Çapraz platform takibi ve entegrasyonlar için Kullanıcılara özel tanımlayıcılar eşleyin.
  </Card>

  <Card title="Etiketler" icon="tags" href="./add-user-data-tags">
    Kişiselleştirme ve segmentasyon için Kullanıcılara anahtar-değer verileri ayarlayın.
  </Card>

  <Card title="Özel olaylar" icon="bolt" href="./custom-events">
    Journey'leri tetiklemek veya analitiği desteklemek için Kullanıcı eylemlerini takip edin.
  </Card>
</Columns>

***

## Eğitimler

OneSignal ile yaygın mesajlaşma kullanım senaryolarını uygulamak için adım adım kılavuzlar.

<Card title="Eğitimler ve kullanım senaryoları" icon="graduation-cap" href="./tutorials">
  Terk edilen sepetler, katılım akışları, yeniden etkileşim kampanyaları ve daha fazlası için uygulama kılavuzlarına göz atın.
</Card>

***

## Test ve hata ayıklama

Tüm kitlenize göndermeden önce entegrasyonunuzun çalıştığını doğrulayın.

<Tip>
  Her zaman önce [test Abonelikleri](./test-users) ile test edin. Bu, gerçek Kullanıcıları etkilemeden teslimat, oluşturma ve derin bağlantıları doğrulamanızı sağlar.
</Tip>

<Columns cols={2}>
  <Card title="Test Abonelikleri" icon="vial" href="./test-users">
    Push, e-posta ve SMS için test Aboneliklerini bulun ve yapılandırın.
  </Card>

  <Card title="Hata ayıklama günlükleri" icon="bug" href="./capturing-a-debug-log">
    Sorun giderme için mobil uygulamalardan ayrıntılı SDK günlükleri yakalayın.
  </Card>

  <Card title="Mobil sorun giderme" icon="mobile" href="./mobile-troubleshooting">
    Yaygın push teslimatı, APNS ve uygulama içi mesajlaşma sorunlarını çözün.
  </Card>

  <Card title="Web sorun giderme" icon="globe" href="./troubleshooting-web-push">
    Service worker, tarayıcı uyumluluğu ve web push sorunlarını düzeltin.
  </Card>
</Columns>

***

## Analitik ve webhook'lar

Mesaj performansını izleyin ve analitik, otomasyon veya harici sistemlerle senkronizasyon için sunucu tarafında mesaj olaylarını alın.

<Columns cols={2}>
  <Card title="Event Streams" icon="signal-stream" href="./event-streams">
    Tıklamalar, açılmalar, alımlar ve diğer mesaj olaylarını gerçek zamanlı olarak veri ambarınıza aktarın.
  </Card>

  <Card title="Journey Webhook'ları" icon="route" href="./journeys-webhook">
    Journey adımlarından sunucunuza HTTP istekleri gönderin.
  </Card>

  <Card title="Web push Webhook'ları" icon="link" href="./webhooks">
    Web push görüntüleme, tıklama ve kapatma olayları için HTTP geri çağırmaları.
  </Card>
</Columns>

***

## Sıkça sorulan sorular

### REST API isteklerini nasıl doğrularım?

REST API anahtarınızı `Authorization` başlığına Bearer token olarak ekleyin: `Authorization: Key YOUR_REST_API_KEY`. Anahtarınızı OneSignal dashboard'undaki **Ayarlar > Anahtarlar ve ID'ler** bölümünde bulabilirsiniz. Ayrıntılar için [Anahtarlar ve ID'ler](./keys-and-ids)'e bakın.

### İstemci SDK'ları ve sunucu SDK'ları arasındaki fark nedir?

**İstemci SDK'ları** (mobil ve web), Kullanıcının cihazındaki uygulamanızda çalışır. Abonelik kaydı, izin istemleri, uygulama içi mesajlar ve `login` aracılığıyla Kullanıcı tanımlamasını yönetir. **Sunucu SDK'ları** arka ucunuzda çalışır ve mesaj göndermek, Kullanıcıları yönetmek ve verileri dışa aktarmak için REST API'yi çağırır.

### Kullanıcıları cihazlar genelinde nasıl tanımlarım?

Kullanıcı oturum açtıktan sonra her cihazda `OneSignal.login("your_external_id")` çağırın. OneSignal, aynı External ID'ye sahip tüm Abonelikleri tek bir Kullanıcı altında birleştirir. Uygulama ayrıntıları için [Kullanıcılar](./users#external-id)'a bakın.

### Kimlik doğrulamayı ayarlamam gerekiyor mu?

Kimlik doğrulama isteğe bağlıdır ancak prodüksiyon uygulamaları için kesinlikle önerilir. Olmadan, herhangi bir istemci rastgele bir External ID ile `login` çağırabilir. [Kimlik doğrulamayı](./identity-verification) etkinleştirmek, OneSignal SDK'yı sunucu tarafından oluşturulan JWT kullanacak şekilde güncellemenizi gerektirir ve kimlik sahtekarlığını önler.

***

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please include:

  * Details of the issue you're experiencing and steps to reproduce if available
  * Your OneSignal App ID
  * The External ID or Subscription ID if applicable
  * The URL to the message you tested in the OneSignal Dashboard if applicable
  * Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>