Bahis Sitesi API Entegrasyonu: Operatörler İçin Odds Feed, Ödeme ve Affiliate Tracking Altyapısı 2026

Bahis sitesi API entegrasyonu, modern iGaming operasyonlarının omurgasını oluşturur. Bir bahis sitesi operatörü olarak odds feed sağlayıcısından canlı oranları çekmek, ödeme gateway üzerinden yatırım ve çekim işlemlerini yönetmek, oyun sağlayıcı katalogunu entegre etmek ve affiliate tracking altyapısını S2S postback ile bağlamak — bunların hepsi API katmanında gerçekleşir. Türk dilli pazarda faaliyet gösteren offshore lisanslı operatörler için bu entegrasyonların doğru kurulması, hem operasyonel verimliliği hem de gelir optimizasyonunu doğrudan etkiler.

Bu rehber, bahis sitesi API entegrasyonunu beş kritik katmanda ele alıyor: odds feed, ödeme altyapısı, oyun sağlayıcı, affiliate tracking ve veri analitiği. Her katman için mimari kararları, güvenlik gereksinimlerini ve affiliate program entegrasyonu açısından nelere dikkat edilmesi gerektiğini detaylandırıyoruz.

Bahis Sitesi API Entegrasyonu Neden Kritiktir?

Bir bahis sitesi API entegrasyonu olmadan çalışamaz. Manuel veri girişi, dosya tabanlı veri aktarımı veya ekran kazıma gibi yöntemler, canlı bahis gibi milisaniye düzeyinde tepki gerektiren işlemlerde kullanılamaz. API entegrasyonu, farklı sistemlerin birbirleriyle yapılandırılmış veri alışverişi yapmasını sağlayan standart arayüzler sunar. REST API ve WebSocket protokolleri iGaming sektöründe baskın standartlardır.

Operatör perspektifinden bakıldığında, API entegrasyonunun kalitesi üç temel alanı etkiler: birincisi operasyonel güvenilirlik — kesintisiz odds akışı ve ödeme işlemleri; ikincisi gelir optimizasyonu — doğru affiliate attribution ve komisyon hesaplaması; üçüncüsü uyumluluk — KVKK ve lisans gereksinimlerine uygun veri işleme.

• Odds feed API: Canlı oranların milisaniye gecikmeyle platforma aktarılması
• Ödeme API: Yatırım, çekim ve KYC doğrulama süreçlerinin otomasyonu
• Oyun sağlayıcı API: Slot, masa oyunları ve canlı casino içeriklerinin entegrasyonu
• Affiliate tracking API: S2S postback, click tracking ve conversion attribution
• Veri analitiği API: GGR, NGR, oyuncu segmentasyonu ve KPI raporlama

Bahis Sitesi API Entegrasyonu: Odds Feed Katmanı

Odds feed, bir bahis sitesinin kalp atışıdır. Canlı bahis operasyonlarında oranlar saniyede yüzlerce kez güncellenebilir. Operatör olarak odds feed API entegrasyonunuz, hem oranların doğruluğunu hem de gecikme süresini doğrudan etkiler. Yanlış yapılandırılmış bir odds feed, arbitraj fırsatları yaratarak operatörü ciddi zararlara uğratabilir.

Odds Feed API Mimarisi

Modern odds feed sağlayıcıları iki temel protokol sunar: REST API ve WebSocket. REST API, talep-yanıt modeliyle çalışır ve pre-match oranlar için uygundur. WebSocket ise sürekli bağlantı üzerinden gerçek zamanlı veri akışı sağlar ve canlı bahis için zorunludur. Sektör tahminlerine göre canlı bahis trafiğinin yüzde sekseninden fazlası WebSocket tabanlı altyapılar üzerinden sunulmaktadır.

1. Sağlayıcı seçimi: Betradar, LSports, BetGenius gibi tier-1 odds feed sağlayıcılarını değerlendirin
2. Gecikme toleransı: Canlı bahis için maksimum kabul edilebilir gecikme 200 milisaniyedir
3. Failover mekanizması: Birincil sağlayıcı kesintisinde ikincil sağlayıcıya otomatik geçiş
4. Veri normalizasyonu: Farklı sağlayıcılardan gelen verilerin tek formatta standartlaştırılması
5. Oran manipülasyonu tespiti: Anormal oran hareketlerinin otomatik izlenmesi

Ödeme Gateway API Entegrasyonu

Ödeme API entegrasyonu, bahis sitesi operatörleri için en hassas katmandır. Türk pazarında faaliyet gösteren offshore operatörler, geleneksel banka transferlerinin yanı sıra kripto para, e-cüzdan ve ön ödemeli kart gibi alternatif ödeme yöntemlerini desteklemelidir. BDDK düzenlemeleri nedeniyle Türk bankalarının offshore bahis sitelerine yapılan transferleri engellemesi, alternatif ödeme raylarının önemini artırmıştır.

Ödeme API Güvenlik Gereksinimleri

Her ödeme API entegrasyonunda PCI DSS uyumluluğu zorunludur. Kart verileri hiçbir zaman operatörün sunucularında saklanmamalı, tokenizasyon ile ödeme sağlayıcısının güvenli ortamında tutulmalıdır. API anahtarları rotasyonu, IP beyaz listesi ve TLS 1.3 şifrelemesi standart güvenlik katmanlarıdır.

Oyun Sağlayıcı API Entegrasyonu

Oyun sağlayıcı API entegrasyonu, bahis sitesinin içerik kataloğunu oluşturur. Slot oyunları, masa oyunları, canlı casino ve sanal sporlar gibi farklı kategorilerdeki oyunlar, sağlayıcıların API arayüzleri üzerinden platforma eklenir. Aggregator modeli, operatörlerin tek bir API noktasından onlarca sağlayıcının içeriğine erişmesini sağlar ve entegrasyon karmaşıklığını önemli ölçüde azaltır.

Aggregator vs Direkt Entegrasyon

Aggregator platformları (SoftSwiss, EveryMatrix, BetConstruct gibi) tek bir API üzerinden yüzlerce oyun sağlayıcısına erişim sunar. Direkt entegrasyon ise her sağlayıcı ile ayrı API bağlantısı gerektirir. Yeni operatörler için aggregator modeli daha hızlı lansman sağlar, ancak komisyon payı nedeniyle uzun vadede maliyetli olabilir. Operatörler, bahis sitesi açma sürecinde bu kararı lisans gereksinimlerine ve bütçeye göre vermelidir.

• Aggregator avantajı: Tek entegrasyon noktası, hızlı lansman, yüzlerce oyun
• Aggregator dezavantajı: Komisyon payı (genellikle GGR üzerinden yüzde beş ile on beş arası)
• Direkt entegrasyon avantajı: Düşük uzun vadeli maliyet, özel anlaşmalar
• Direkt entegrasyon dezavantajı: Her sağlayıcı için ayrı teknik çalışma ve bakım

Affiliate Tracking API Entegrasyonu: Bahis Sitesi İçin

Affiliate tracking API entegrasyonu, bahis sitesi operatörleri için gelir motorunun kritik bileşenidir. Affiliate kanalı, sektör tahminlerine göre offshore bahis sitelerinin yeni oyuncu ediniminin yüzde kırkından fazlasını oluşturur. Bu kanalın performansını doğru ölçmek, komisyonları hatasız hesaplamak ve dolandırıcılığı tespit etmek ancak sağlam bir API entegrasyonu ile mümkündür.

S2S Postback Mimarisi

Server-to-server (S2S) postback, modern affiliate tracking standartıdır. Cookie tabanlı izleme, tarayıcı gizlilik politikaları nedeniyle güvenilirliğini büyük ölçüde yitirmiştir. S2S postback modelinde, bahis sitesi sunucusu conversion olayını (kayıt, FTD, işlem hacmi) doğrudan affiliate yönetim platformunun API endpoint noktasına bildirir. Track360 affiliate tracking altyapısı bu postback verilerini gerçek zamanlı işleyerek komisyon hesaplaması, attribution doğrulaması ve fraud tespiti yapar.

Affiliate API Entegrasyon Adımları

1. API kimlik doğrulama: OAuth 2.0 veya API key tabanlı yetkilendirme yapılandırması
2. Event mapping: Kayıt, FTD (ilk para yatırma), işlem hacmi ve çekim olaylarının tanımlanması
3. Postback URL yapılandırması: Her conversion türü için ayrı endpoint belirlenmesi
4. Attribution penceresi: Click-to-conversion süresinin belirlenmesi (genellikle 30-90 gün)
5. Veri doğrulama: Test trafiği ile postback akışının uçtan uca doğrulanması
6. Fraud filtreleri: Sahte kayıt, self-referral ve click injection kontrollerinin aktifleştirilmesi

API Güvenliği ve KVKK Uyumu

Bahis sitesi API entegrasyonlarında güvenlik, operasyonel bir gereklilik olmanın ötesinde yasal bir zorunluluktur. KVKK (Kişisel Verilerin Korunması Kanunu) kapsamında oyuncu verilerinin API üzerinden aktarılması sırasında veri minimizasyonu, amaç sınırlaması ve güvenlik tedbirleri uygulanmalıdır.

API Güvenlik Katmanları

OWASP API Security Top 10 çerçevesi, iGaming API güvenliği için temel referans noktasıdır. Operatörler en azından şu güvenlik katmanlarını uygulamalıdır: API anahtarı rotasyonu (minimum 90 günde bir), istek hız sınırlaması (rate limiting), IP tabanlı erişim kontrolü, giriş veri doğrulaması (input validation) ve detaylı API denetim günlükleri (audit logging). Hassas verilerin (oyuncu kimlik bilgileri, finansal veriler) API yanıtlarında maskelenmesi de zorunludur.

• TLS 1.3 şifrelemesi: Tüm API trafiği şifreli olmalıdır
• OAuth 2.0 yetkilendirme: Üçüncü taraf entegrasyonlar için token tabanlı erişim
• Rate limiting: DDoS ve brute-force saldırılarına karşı istek sınırlaması
• Webhook doğrulama: HMAC imzalı webhook gönderileri ile veri bütünlüğü kontrolü
• Veri maskeleme: PII (kişisel tanımlayıcı bilgiler) API yanıtlarında maskelenmeli

Bahis Sitesi API Entegrasyonu: Veri Analitiği Katmanı

Veri analitiği API katmanı, operatörlere gerçek zamanlı karar alma kapasitesi sağlar. GGR (Gross Gaming Revenue), NGR (Net Gaming Revenue), oyuncu segmentasyonu, kohort analizi ve affiliate performans metrikleri gibi kritik veriler, analitik API aracılığıyla merkezi bir panelde birleştirilir. Bu veriler, hem operasyonel kararları hem de affiliate komisyon stratejisini doğrudan etkiler.

Analitik API ile Affiliate Performans İzleme

Affiliate kanalının performansını doğru ölçmek için analitik API, şu metrikleri gerçek zamanlı olarak raporlamalıdır: click-to-registration oranı, FTD dönüşüm oranı, affiliate başına oyuncu LTV (lifetime value), CPA (cost per acquisition) ve RevShare NGR hesaplaması. Track360 raporlama altyapısı bu metrikleri affiliate portalında gerçek zamanlı sunar ve operatör ile affiliate arasında şeffaf bir veri paylaşımı sağlar.

• Kohort analizi: Affiliate kaynaklı oyuncuların aylık retention ve GGR trendi
• Segment karşılaştırması: Organik vs affiliate vs paid oyuncu segmentlerinin LTV farkı
• Fraud skoru: Her affiliate için otomatik hesaplanan risk puanı
• Gerçek zamanlı dashboard: API endpoint üzerinden canlı KPI akışı

Bahis Sitesi API Entegrasyonu İçin Mimari Kararlar

API entegrasyon mimarisinde operatörler üç temel karar vermelidir: monolitik vs mikro servis yaklaşımı, senkron vs asenkron veri akışı ve self-hosted vs bulut tabanlı altyapı. Her kararın maliyet, performans ve bakım yükü açısından farklı sonuçları vardır.

Bahis Sitesi API Entegrasyonu: Uygulama Yol Haritası

Bahis sitesi API entegrasyonu projesini dört aşamada planlamak, riskleri minimize eder ve lansman süresini kısaltır. Her aşama, bir öncekinin başarılı tamamlanmasına bağlıdır.

1. Aşama 1 — Temel altyapı (4-6 hafta): Ödeme API entegrasyonu, KYC doğrulama, hesap yönetimi
2. Aşama 2 — İçerik katmanı (3-4 hafta): Oyun sağlayıcı API entegrasyonu (aggregator veya direkt)
3. Aşama 3 — Bahis motoru (4-8 hafta): Odds feed API entegrasyonu, risk yönetimi, canlı bahis altyapısı
4. Aşama 4 — Büyüme katmanı (2-3 hafta): Affiliate tracking API entegrasyonu, analitik API, CRM entegrasyonu

Aşama 4 olan affiliate tracking entegrasyonu, operatörlerin sıklıkla ertelediği ancak en yüksek ROI sağlayan katmandır. Affiliate kanalı olmadan lansman yapan operatörler, oyuncu edinme maliyetlerini yalnızca paid kanallara bağımlı hale getirir. Track360 entegrasyon altyapısı ile affiliate tracking API entegrasyonu iki ile dört hafta içinde tamamlanabilir ve ilk günden itibaren affiliate kanalı aktif hale gelir.

Türk Pazarına Özgü API Entegrasyon Gereksinimleri

Türk dilli pazarda faaliyet gösteren offshore bahis sitesi operatörleri, API entegrasyonlarında birkaç özel gereksinimle karşılaşır. BDDK düzenlemeleri nedeniyle geleneksel bankacılık kanallarının kısıtlı olması, ödeme API katmanında alternatif çözümleri zorunlu kılar. KVKK uyumu, oyuncu verilerinin API üzerinden aktarılmasında veri minimizasyonu ve açık rıza mekanizmalarını gerektirir.

• Türk Lirası volatilitesi: Ödeme API entegrasyonunda çoklu döviz desteği ve anlık kur hesaplama zorunludur
• VPN ve DNS engelleri: API altyapısının alternatif erişim noktaları ve CDN desteği sağlaması gerekir
• Yerelleştirilmiş KYC: TC kimlik doğrulama API entegrasyonu (Türk oyuncular için)
• Türkçe dil desteği: API hata mesajları ve webhook bildirimlerinin Türkçe desteklemesi
• KVKK veri saklama: Kişisel verilerin Türkiye dışında işlenmesinde açık rıza mekanizması

API entegrasyonlarında Türk pazarının en önemli farkı, ödeme altyapısının esnekliğidir. Operatörler, bahis sitesi ödeme yöntemleri stratejilerini API entegrasyonu ile birlikte planlamalıdır. Ödeme sağlayıcı API kesintilerinde otomatik failover mekanizması, Türk pazarında operasyonel sürekliliğin anahtarıdır.

Bahis sitesi API entegrasyonu, operatörlerin teknik altyapısının temelini oluşturur. Odds feed, ödeme, oyun sağlayıcı, affiliate tracking ve analitik katmanlarının her biri, ayrı ayrı optimize edilmeli ve bir bütün olarak çalışmalıdır. Türk dilli pazarda başarılı olmak isteyen operatörler, API entegrasyonlarını lansman öncesinde titizlikle planlamalı ve özellikle affiliate tracking katmanını ilk günden devreye almalıdır.