Casplay Veri Besleme API
Maç öncesi ve canlı bülten, tam oran kataloğu, canlı durum, anlık akış ve seçenek bazında sonuç — kendi bahis motorunu çalıştıran operatörler için.
Marj, limit, bahis kabulü ve ödeme sizde; veriyi ve her seçeneğin sonucunu biz veririz. iframe ve cüzdan callback'i yoktur — yalnız veri ürünüdür (iframe spor sitesi için iframe entegrasyon dökümanına bakın).
Sözlük
| Terim | Anlamı |
|---|---|
| Event (maç) | Bir maç (veya uzun vadeli / özel bahis). Kalıcı metin ID. |
| Market | Bir maçın bahis türü, ör. maç sonucu, toplam gol 2.5. Anahtarı + params ile tanımlanır. |
| Seçenek | Marketin bir sonucu (ör. “2.5 Üst”) ve oranı. Sonuçlar seçenek bazında verilir. |
| settle | Markette true = sonucunu biz yayımlarız; false = bizden sonuç gelmez. |
| schema | Yanıt biçiminin sürümü. Yalnız geriye uyumsuz değişiklikte artar; yeni alanlar her zaman eklenebilir. |
Hızlı başlangıç
- Erişim alın. Veri beslemesini hesabınız için bayiniz (veya Casplay) açar — durumu panelinizde Entegrasyon sekmesinde görürsünüz. Açılana kadar her çağrı 403 feed_disabled döner.
- Token'ı kopyalayın. Panel → Entegrasyon → SPORTS_API_TOKEN. Yalnız sunucunuzda tutun.
- Sunucu IP'nizi ekleyin. Aynı sekme → İzinli IP'ler. Liste boşsa her çağrı reddedilir.
- Bülteni yükleyin: GET /fixtures, gösterdiğiniz maçlar için GET /event/{id}.
- Anlık akışı açın ve değişiklikleri durumunuza işleyin.
- Bahislerinizi sonuçlandırın: bet_settlement veya GET /results.
Canlı oran nasıl güncellenir
Oranlar olay tetiklidir, saat tık'ı değil. Bir oran yalnız gerçekten değiştiğinde gönderilir — sakin bir market aynı oranı birkaç saniye tutabilir; bu doğrudur, arıza da bloke de değildir. Mesaj yoksa oran değişmemiştir ve hâlâ geçerlidir. Saniyede bir güncelleme beklemeyin; öyle bir şey yok.
| Gördüğünüz | Anlamı |
|---|---|
| birkaç saniye odds_change yok | oran hareket etmedi — elinizdeki oranı göstermeye devam edin |
| odds_change | oran (ya da frozen) değişti — yeni market satırlarını uygulayın |
| frozen: true olan seçenek | o seçenek bir an askıda (gol, VAR, son dakika parası) — kendiliğinden açılır; sistem bloğu değil |
| her 10 sn alive | akış canlı — canlılık sinyali, veri değil; üst üste üçünü kaçırırsanız yeniden bağlanın |
Kimlik & erişim
Her REST çağrısında ve WebSocket el sıkışmasında
Authorization: Bearer {SPORTS_API_TOKEN}
Accept-Encoding: gzip| Kural | Ayrıntı |
|---|---|
| Temel adres | https://spor.casplay.net/v2/feed · akış wss://spor.casplay.net/v2/feed/stream |
| İzinli IP | Yalnız panelinizdeki IP listesinden gelen istekler kabul edilir. |
| Etkinleştirme | Veri beslemesini hesabınız için bayiniz (veya Casplay) açar; açılana kadar 403 feed_disabled. |
| Limitler | Hesap başına dakikada 1200 REST isteği (aşılırsa 429 rate_limited) · dakikada 300 Bet Builder isteği · hesap başına en fazla 5 akış bağlantısı. |
| Sıkıştırma | Accept-Encoding: gzip gönderin — tüm bülten ~1,2 MB, sıkıştırılmış ~160 KB. |
| Dil | ?lang= en tr de fr es pt ar ur he hi zh ko fa (varsayılan en). Takım, lig, kategori, market, seçenek, spor ve periyot adlarının hepsi bu dilde gelir. |
Yanıtlar & hatalar
Her başarılı yanıt: { ok: true, schema, ts, lang, data }. ts = sunucu zamanı (ms). Tanımadığınız alanı yok sayın — yeni alanlar her zaman eklenebilir.
Hatalar gerçek HTTP durum koduyla ve şu gövdeyle döner:
{ "ok": false, "error": { "code": "ip_not_allowed", "message": "IP not allowed: 203.0.113.7" } }
| HTTP | code | Anlamı |
|---|---|---|
| 401 | unauthorized | token yok veya yanlış |
| 403 | ip_not_allowed | IP izinli listede değil (veya liste boş) |
| 403 | feed_disabled | veri beslemesi bu hesapta açık değil |
| 403 | account_inactive · subscription_expired · credit_exceeded | hesap kapalı |
| 404 | not_found | maç, sonuç veya uç bulunamadı |
| 405 | method_not_allowed | yanlış yöntem (her yerde GET; yalnız /betbuilder/price POST) |
| 429 | rate_limited · too_many_connections | yavaşlayın |
| 500 | internal | sonra tekrar deneyin |
ID'ler & anahtarlar
- Tüm ID'ler metin ve kalıcıdır: maç, takım, lig, kategori.
- Market anahtarı m{marketType}_p{period}[_s{subPeriod}][_r{resultKind}] — ör. m2_p0 maç sonucu, m5_p0_r4 toplam korner, m5_p1_s85 85. dakikaya kadar toplam gol. Çizgili marketler (alt/üst, handikap) her çizgi için ayrı satırdır; çizgi params içindedir.
- Seçimin kimliği = maç ID + market anahtarı + params + seçenek type + values. Her bahiste bunları saklayın — sonuçlar aynı kimlikle gelir.
| resultKind | Birim |
|---|---|
| 1 | ana birim (gol / sayı / set / harita) |
| 4 | korner |
| 8 | kart |
| 16 | kırmızı kart |
| 2 | faul |
| 14 | şut |
| 66 | isabetli şut |
| 67 | ofsayt |
Maç alanları
| Alan | Değerler |
|---|---|
| stage | prematch · live · finished |
| status | not_started started paused finished retired abandoned interrupted cancelled postponed |
| trading | open · suspended (maçın tamamı askıda) · closed (başladı, bitti veya güncellenmiyor). open değilse bahis almayın. |
| phase | canlı: o anki evre, istenen dilde — ör. 1. yarı, Devre arası, 3. çeyrek, 2. set, Penaltılar |
| score | sporun ana biriminde maç toplamı (gol, sayı, set, harita, run) |
| periods | periyot skorları — bkz. Periyotlar |
| scoreWithExtra | futbol: uzatma ve penaltılar dahil toplam (score'dan farklıysa) |
| gameScore | tenis canlı: o anki oyunun puanı, ör. "40-15" |
| stats | goals corners cards red_cards fouls shots shots_on_target offsides sets games points maps rounds runs wickets — her biri {home, away}; bilinmeyen kodlar rk<n> |
| clock | canlı: seconds minute running countdown (geri sayan sporlar) |
| serving | tenis / voleybol / masa tenisi / badminton canlı: home · away |
| betBuilder | true = aynı maç kombinesi var — bkz. Bet Builder |
| logo · flag · icon | kendi alan adımızda görsel adresleri: takım logosu (competitors[].logo), ülke/kategori bayrağı (category.flag), spor simgesi (/sports → icon) — bkz. Görseller |
| odd · frozen | ondalık oran; frozen: true = seçenek şu an askıda |
| order | marketin sayfadaki yeri — her dilde aynı olan bir sayı. Marketleri order alanına göre sıralayın; aynı key içindeki çizgiler zaten params sırasıyla (0.5, 1.5, 2.5 …), seçenekler de sabit sırayla (1X2: type 0, 1, 3) gelir. name alanına göre sıralamayın ve eşleştirmeyin — adlar lang ile değişir. |
| settle | true = bu marketin sonucu bizde (/results, bet_settlement). false = bizden sonuç gelmez; kendi kaynağınızla sonuçlandırın veya sunmayın. |
| complete | /event/{id}: maç öncesi maçta ilk istekte false — yalnız ana marketler; tam katalog birkaç saniye içinde gelir (tekrar isteyin veya akışı kullanın). |
Periyotlar
| Spor | Periyot etiketleri |
|---|---|
| Futbol (F) | 1H 2H ET1 ET2 (gol) |
| Basketbol (B) | Q1 Q2 Q3 Q4 OT 1H 2H (sayı; OT = 4. çeyrekten sonrası) |
| Buz hokeyi (H) | P1 P2 P3 OT (gol) |
| Tenis (T) | S1 S2 … set başına oyun (skor = set) |
| Voleybol, masa tenisi, badminton, plaj voleybolu | S1 S2 … set başına sayı (skor = set) |
| E-spor (CS) | M1 M2 … harita başına raunt (skor = harita) |
| Diğer sporlar | providerPeriods: ham sağlayıcı periyotları (period: 1 = maç toplamı; diğer kodlar garanti edilmez) |
Sporlar
Açık maçı olan sporlar. Kodlar: F futbol, B basketbol, T tenis, H buz hokeyi, CS e-spor, TT masa tenisi, VB voleybol, HB hentbol, CK kriket, BB beyzbol…
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/sports?lang=tr"
Yanıt · 200
{
"ok": true, "schema": 1, "ts": 1792148629547, "lang": "tr",
"data": [ { "id": "F", "name": "Futbol", "icon": "https://spor.casplay.net/v2/img/sport/f", "live": 32, "prematch": 555 }, "…" ]
}
Ligler
Şu an açık maçı olan tüm ligler / turnuvalar; ülkesi ve maç sayılarıyla. İsteğe bağlı süzgeçler: sport (kod), category (id). id değerini /fixtures'ta tournament olarak kullanın.
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/tournaments?sport=F&lang=tr"
Yanıt · 200
{
"ok": true, "schema": 1, "ts": 1792148629547, "lang": "tr",
"data": [ { "id": "17", "name": "Premier Lig", "sport": "F",
"category": { "id": "1", "name": "İngiltere", "country": "GB", "flag": "https://spor.casplay.net/v2/img/flag/gb" },
"live": 2, "prematch": 18 }, "…" ]
}
Bülten
Açık maçlar (maç öncesi + canlı), başlama saatine göre sıralı. Bitenler /results'ta.
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| sport | hayır | spor kodu, ör. F |
| stage | hayır | prematch veya live |
| tournament · category | hayır | lig / kategori ID |
| from · to | hayır | başlama zamanı aralığı (ISO) |
| lang | hayır | ad dili (varsayılan en) |
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/fixtures?sport=F&stage=live&lang=tr"
Yanıt · 200
{
"ok": true, "schema": 1, "ts": 1792094101023, "lang": "en",
"data": [{
"id": "18898080", "sport": "F",
"category": { "id": "b7d9493d…", "name": "Guatemala", "country": "GTM", "flag": "https://spor.casplay.net/v2/img/flag/gtm" },
"tournament": { "id": "e83fc447…", "name": "National League" },
"name": "Xelaju MC - CD Malacateco",
"competitors": [ { "id": "18058", "name": "Xelaju MC", "side": "home", "logo": "https://spor.casplay.net/v2/img/team/18058" },
{ "id": "78117", "name": "CD Malacateco", "side": "away", "logo": "https://spor.casplay.net/v2/img/team/78117" } ],
"startTime": "2026-10-15T19:00:00.000Z",
"stage": "live", "status": "started", "trading": "open",
"betBuilder": true, "marketCount": 78,
"score": { "home": 2, "away": 1 },
"periods": [ { "period": "1H", "home": 1, "away": 1 }, { "period": "2H", "home": 1, "away": 0 } ],
"stats": { "goals": { "home": 2, "away": 1 }, "corners": { "home": 5, "away": 3 } },
"clock": { "seconds": 5581, "minute": 93, "running": true, "countdown": false }
}]
}
Maç detayı
Tek maç: tüm marketler ve oranlar. Oranı olmayan seçenekler gönderilmez. Maç öncesi maçlar için Maç alanları'ndaki complete alanına bakın.
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/event/18680637?lang=tr"
Yanıt · 200
{
"ok": true, "schema": 1, "ts": 1792094390486, "lang": "en",
"data": {
"id": "18680637", "sport": "F", "stage": "prematch", "trading": "open", "…": "same fields as fixtures",
"markets": [
{ "key": "m2_p0", "marketType": 2, "period": 0, "resultKind": 1, "params": [],
"name": "Full-time result", "settle": true,
"outcomes": [ { "type": 0, "values": [], "name": "Hearts", "odd": 1.44, "frozen": false },
{ "type": 1, "values": [], "name": "Draw", "odd": 4, "frozen": false },
{ "type": 3, "values": [], "name": "FC Nordsjaelland", "odd": 7.5, "frozen": true } ] },
{ "key": "m5_p0", "marketType": 5, "period": 0, "resultKind": 1, "params": ["2.5"],
"name": "Total goals", "settle": true,
"outcomes": [ { "type": 4, "values": [], "name": "Over 2.5", "odd": 1.7, "frozen": false },
{ "type": 5, "values": [], "name": "Under 2.5", "odd": 2.05, "frozen": false } ] },
{ "key": "m5_p1_s85", "marketType": 5, "period": 1, "subPeriod": 85, "resultKind": 1, "params": ["2.5"],
"name": "Total goals until minute 85", "settle": true, "outcomes": [ "…" ] }
]
}
}
Ad sözlüğü
Tüm market ve seçenek tiplerinin ham ad şablonları (kendi etiketlerinizi üretmek için). cond = spor:resultKind:periyot:param1:param2 koşulları (= eşit, ! değil, >, <, boş = hepsi); ilk eşleşen varyant geçerlidir.
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/dictionary?lang=tr"
Sonuçlar
Biten maçlar ve her settle: true marketin her seçeneğinin sonucu — kendi bahislerimizi sonuçlandıran motorla aynı kurallarla hesaplanır. Liste son 48 saati kapsar — en az günde bir sorgulayın.
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| since | hayır | ISO zaman, updatedAt'e göre süzer — gördüğünüz son updatedAt ile sorgulayın; yeni sonuçlar ve sonradan gelen düzeltmeler gelir. Varsayılan: son 24 saat; en çok 48 saat geriye (daha eski değer 48 saat sayılır). |
| sport | hayır | spor kodu |
| markets | hayır | 0 = yalnız skorlar |
| lang | hayır | ad dili |
Sonuç değerleri
| result | S tutarlı, O oranlı bahsin ödemesi |
|---|---|
| won | S × O |
| lost | 0 |
| void | S (iade) |
| half_won | S/2 × O + S/2 (Asya çizgileri) |
| half_lost | S/2 (Asya çizgileri) |
| pending | henüz kesin değil — resmî teyit bekleniyor; sonuçlandırmayın |
- confirmed: true = bekleyen seçenek kalmadı; kayıt artık değişmez.
- Bazı marketler (futbol yarıları, korner/kart, dakika aralıkları, futbol dışı periyot marketleri, kriket) resmî sonucu bekler — genelde dakikalar, en fazla 48 saat. 48 saatte resmî sonuç gelmezse bekleyen seçenekler void olur ve noResult: true.
- cancelled: true = maç resmî olarak iptal; seçenekleri void.
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/results?since=2026-10-15T21:00:00Z&lang=tr"
Yanıt · 200
{
"ok": true, "schema": 1, "ts": 1792098114821, "lang": "en",
"data": [{
"id": "19022083", "sport": "B", "name": "KR Reykjavik - UMFN Njardvik", "stage": "finished", "status": "finished",
"finishedAt": "2026-10-15T21:01:12.000Z", "updatedAt": "2026-10-15T21:01:45.000Z", "confirmed": true,
"score": { "home": 84, "away": 73 },
"periods": [ { "period": "Q1", "home": 18, "away": 24 }, { "period": "Q2", "home": 17, "away": 17 }, "…" ],
"markets": [
{ "key": "m145_p0", "marketType": 145, "period": 0, "resultKind": 1, "params": [],
"outcomes": [ { "type": 0, "values": [], "result": "won" }, { "type": 3, "values": [], "result": "lost" } ] },
{ "key": "m800_p0", "marketType": 800, "period": 0, "resultKind": 1, "params": ["-10.75"],
"outcomes": [ { "type": 86, "values": [], "result": "half_won" }, { "type": 87, "values": [], "result": "half_lost" } ] }
]
}]
}
Bet Builder marketleri
Bir maçta birlikte oynanabilen marketler (aynı maç kombinesi), adları ve güncel tekli oranlarıyla: { eventId, available, markets:[…] } — market satırı biçimi /event/{id} ile aynı. Maçta betBuilder: true ise vardır.
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/betbuilder/18012490?lang=tr"
Bet Builder oranı
Aynı maçın 2–12 seçimi için korelasyonlu kombine oran.
İstek
POST https://spor.casplay.net/v2/feed/betbuilder/price
Authorization: Bearer {SPORTS_API_TOKEN}
Content-Type: application/json
{ "eventId": "18012490",
"selections": [ { "key": "m2_p0", "params": [], "type": 0, "values": [] },
{ "key": "m5_p0", "params": ["2.5"], "type": 4, "values": [] } ] }
Yanıt · 200
{ "ok": true, "data": { "eventId": "18012490", "available": true, "odd": 3.85, "notAvailable": [] } }
Maç takibi
Maçın hareketli canlı takip ekranı (saha/kort radarı; canlı istatistik, kadro ve olay akışıyla). url adresini <iframe> içinde gösterin. Çoğunlukla futbol, basketbol, tenis ve diğer büyük sporlarda maç canlıyken vardır; yoksa available: false. Kullanıcı maçı açınca isteyin — adres maç boyunca değişmez.
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| lang | hayır | takip ekranının dili |
| theme | hayır | dark (varsayılan) veya light |
İstek
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/event/18936236/tracker?lang=tr&theme=dark"
Yanıt · 200
{ "ok": true, "data": { "eventId": "18936236", "available": true, "type": "radar", "url": "https://…" } }
Anlık akış — bağlantı
REST ile aynı Authorization başlığı ve IP kuralları. Her mesajda artan seq ve sunucu zamanı ts vardır.
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| lang | hayır | ad dili |
| live | hayır | 1 (varsayılan) = tüm canlı maçlar · 0 = hiçbiri |
| prematch | hayır | 1 = tüm maç öncesi maçlar (varsayılan 0) |
| sports | hayır | yalnız bu sporlar, ör. F,B |
| events | hayır | yalnız bu maçlar, ör. id1,id2 (sonradan abone de olabilirsiniz) |
| session · since | hayır | kopmadan sonra kaldığı yerden devam — bkz. Yeniden bağlanma |
Maç öncesi bir maça abone olmak o maçın tüm marketlerini de açar.
Mesajlar
| type | Ne zaman |
|---|---|
| hello | ilk mesaj: sessionId, seçenekleriniz ve resumed |
| odds_change | oran veya askı değişti — değişen market anahtarlarının tüm satırları, /event/{id} ile aynı biçim. Bir anahtarın gelen satırları, o anahtar için elinizdekilerin yerine geçer (listede artık olmayan çizgi kapanmıştır). removed (isteğe bağlı anahtar dizisi) = artık hiç sunulmayan marketler — silin |
| event_status | skor, periyot, evre, durum veya bahis durumu değişti — /fixtures'taki nesnenin aynısı |
| fixture_change | change: "new" yeni maç · change: "removed" maç akıştan kalktı (2 dk güncelleme yok) |
| bet_settlement | bir sonuç hesaplandı veya güncellendi — /results'taki nesnenin aynısı |
| alive | 10 sn'de bir canlılık sinyali; üçünü kaçırırsanız yeniden bağlanın |
| subscribed · unsubscribed · options | op mesajınızın onayı (gerçekten eklenen/çıkarılan maç ID'leri ya da geçerli seçenekler) |
| resync_required | oturum sürdürülemedi — bkz. Yeniden bağlanma |
| error | access_revoked: veri erişimi kaldırıldı (Veri API kapatıldı, hesap kapandı, IP çıkarıldı) — bağlantı 4003 koduyla kapanır · bad_json / unknown_op: mesajınız okunamadı (bağlantı açık kalır) |
// server → client
{ "type": "hello", "schema": 1, "ts": 1792098097803, "sessionId": "3f9c…", "resumed": false, "seq": 0, "lang": "en", "live": true, "prematch": false, "sports": null, "eventIds": [] }
{ "type": "odds_change", "seq": 1, "ts": 1792098098265, "eventId": "18968312",
"markets": [ { "key": "m1_p0", "params": [], "name": "Winner", "settle": true,
"outcomes": [ { "type": 0, "values": [], "name": "Cloud9", "odd": 1.38, "frozen": false }, "…" ] } ] }
{ "type": "odds_change", "seq": 9, "ts": 1792098098301, "eventId": "19044714", "markets": [], "removed": [ "m2_p0", "m5_p1" ] }
{ "type": "event_status", "seq": 24, "ts": 1792098098767, "event": { "id": "19044714", "stage": "live", "score": { "home": 1, "away": 5 }, "…": "same as /fixtures" } }
{ "type": "fixture_change", "seq": 143, "ts": 1792098104785, "change": "new", "event": { "…": "same as /fixtures" } }
{ "type": "fixture_change", "seq": 150, "ts": 1792098109785, "change": "removed", "eventId": "19061250" }
{ "type": "bet_settlement", "seq": 217, "ts": 1792098114821, "result": { "…": "same as /results" } }
{ "type": "alive", "seq": 140, "ts": 1792098103731 }
// client → server
{ "op": "subscribe", "eventIds": ["18680637", "18882446"] }
{ "op": "unsubscribe", "eventIds": ["18680637"] }
{ "op": "options", "live": true, "prematch": false, "sports": ["F", "B"] }
Yeniden bağlanma & kapanma kodları
- hello'daki sessionId'yi ve işlediğiniz son seq'i saklayın.
- ?session=<sessionId>&since=<seq> ile yeniden bağlanın. Oturum koptuktan sonra 5 dakika mesaj biriktirir ve sırayla tekrar gönderir (replay: true).
- resync_required gelirse (oturum bilinmiyor veya çok uzun kopuk kaldınız) durumu /fixtures, /event/{id} ve /results?since= ile tazeleyin.
Sunucu 10 sn'de bir WebSocket ping gönderir — standart istemciler otomatik yanıtlar.
| Kapanma kodu | Anlamı |
|---|---|
| 4003 | erişim kaldırıldı (hata mesajına bakın) |
| 4000 | aynı session başka bir bağlantıyla açıldı |
| 1008 | mesajları çok yavaş okuyorsunuz (birikti) |
| 1001 | 75 sn yanıt yok ya da sunucu yeniden başladı — session + since ile yeniden bağlanın |
| 1009 | gönderdiğiniz mesaj çok büyük |
Uçtan uca örnek
En küçük ayrıntısına kadar, çalışan tek bir entegrasyon. {SPORTS_API_TOKEN} panel token'ınız; çağrı yaptığınız sunucu IP'si izinli IP listenizde olmalı.
1 · Bülteni bir kez yükle (REST)
Tüm canlı maçları ana-market oranlarıyla tek çağrıda çekin. --compressed = Accept-Encoding: gzip gönderir (~1,2 MB ham → ~160 KB gzip):
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/fixtures?stage=live&odds=1&lang=tr"
Ve tek bir maçın tam market derinliği:
curl -H "Authorization: Bearer {SPORTS_API_TOKEN}" --compressed "https://spor.casplay.net/v2/feed/event/18680637?lang=tr"
2 · Bir marketi oku
Her market — /event/{id}'de ve her odds_change'de — şu biçimdedir:
{ "key": "m2_p0", "name": "Maç sonucu", "settle": true, "params": [],
"outcomes": [ { "type": 0, "name": "Hearts", "odd": 1.44, "frozen": false },
{ "type": 1, "name": "Beraberlik", "odd": 4, "frozen": false },
{ "type": 3, "name": "FC Nordsjaelland", "odd": 7.5, "frozen": true } ] }
- Her seçeneği bir demet (tuple) olarak sakla: maç id + key + params + seçenek type + values — burada 18680637 · m2_p0 · [] · 0 · []. Sonuçlar ve bet_settlement tam olarak aynı demeti kullanır; eşleştirmeyi bununla yaparsınız.
- Çizgili marketler (toplam, handikap) çizgiyi params'ta taşır: m5_p0 + params: ["2.5"] → Üst = type 4, Alt = type 5.
- Bahsi yalnız maç trading: "open" ve o seçenek frozen: false iken kabul edin.
3 · Akışla canlı kal — polling yok
Kopyala-çalıştır istemci: bağlanır, her değişikliği uygular ve kopma sonrası hiç mesaj kaçırmadan kaldığı yerden devam eder.
// Minimal Node.js stream client (npm i ws · Node 18+). Server-to-server only.
import WebSocket from 'ws';
const BASE = 'wss://spor.casplay.net/v2/feed/stream';
const TOKEN = process.env.SPORTS_API_TOKEN; // keep on the server, never in a browser
let sessionId = null; // from the first "hello"
let lastSeq = 0; // highest seq you have applied
const book = new Map(); // eventId -> { markets } : your in-memory odds
function connect() {
// First time: ?live=1 . After a drop: resume with session + since so nothing is missed.
const q = sessionId
? '?session=' + sessionId + '&since=' + lastSeq
: '?live=1&lang=en';
const ws = new WebSocket(BASE + q, { headers: { Authorization: 'Bearer ' + TOKEN } });
ws.on('message', (data) => {
const m = JSON.parse(data); // one JSON object per message
if (typeof m.seq === 'number') lastSeq = Math.max(lastSeq, m.seq);
switch (m.type) {
case 'hello': sessionId = m.sessionId; break; // store it to resume
case 'odds_change': applyOdds(m.eventId, m.markets, m.removed); break; // full rows of changed keys
case 'event_status': applyStatus(m.event); break; // score / phase / trading
case 'fixture_change': m.change === 'new' ? addEvent(m.event) : removeEvent(m.eventId); break;
case 'bet_settlement': settle(m.result); break; // same shape as /results
case 'alive': break; // heartbeat only - no data
case 'resync_required': bootstrapFromRest(); break; // reload /fixtures + /results
case 'error': console.error('stream', m.code, m.message); break;
}
});
// The server pings every 10 s; the ws library answers the pong automatically.
ws.on('close', (code) => { console.log('closed', code, '- reconnecting'); setTimeout(connect, 1000); });
ws.on('error', () => {}); // a 'close' event always follows
}
function applyOdds(eventId, markets, removed) {
const ev = book.get(eventId) || { markets: {} };
// The message carries ALL current lines of every changed key, and "removed" lists keys
// that are no longer offered -> first drop every row you hold for those keys, then add
// the new rows. Otherwise closed lines / withdrawn markets stay on screen with old odds.
const changed = new Set([...markets.map((mk) => mk.key), ...(removed || [])]);
for (const id of Object.keys(ev.markets)) if (changed.has(ev.markets[id].key)) delete ev.markets[id];
// A market with lines (totals, handicaps) shares one key but differs by params,
// so the identity is key + params - not key alone (never the position in the list).
for (const mk of markets) ev.markets[mk.key + '|' + (mk.params || []).join(',')] = mk;
book.set(eventId, ev);
}
connect();
4 · Sonuçlandır
Sonuç geldiğinde — akışta bet_settlement ya da dakikada bir GET /results?since= — sakladığınız her seçenek demetini bulup ödeyin:
| result | S bahis, O oran için ödeme |
|---|---|
| won | S × O |
| void | S (iade) |
| half_won | S/2 × O + S/2 |
| half_lost | S/2 |
| lost | 0 |
| pending | bekle — henüz kesin değil |
Kombine (Bet Builder dahil) yalnız tüm seçenekler won ise kazanır. Yalnız settle: true marketlerin sonucu bizden gelir.
Görseller
Takım logoları, ülke/kategori bayrakları ve spor simgeleri kendi alan adımızdan verilir. Token gerekmez — adresleri doğrudan <img src> içinde kullanın. Tarayıcı önbelleği uzundur (7 gün).
| Görsel | Kaynak alan |
|---|---|
| takım / oyuncu logosu (WebP) | competitors[].logo |
| ülke veya kategori bayrağı | category.flag (category.country, küçük harf) |
| spor simgesi | /sports → icon (küçük harf spor kodu) |
Önerilen akış
- Başlangıç: /fixtures (gösterdiğiniz maçlar için /event/{id}).
- Akışı açın; odds_change, event_status, fixture_change mesajlarını durumunuza işleyin. Gösterdiğiniz maç öncesi maçlara abone olun (op: subscribe) veya prematch=1 kullanın.
- Bahsi yalnız maç trading: open ve seçenek frozen değilken kabul edin.
- Seçeneğin sonucu pending değilken bet_settlement ile (veya dakikada bir /results?since=) sonuçlandırın.
Kapsam
| Alan | Kapsam |
|---|---|
| Maçlar | akıştaki tüm maç öncesi ve canlı maçlar, özel/uzun vadeli bahis "maçları" dahil |
| Sonuçlar | tüm seçeneklerin yaklaşık %88'inin sonucu bizden gelir (canlı örnek, Ekim 2026) — futbol ve basketbol ~%100 (futbolda 1. yarı korner dahil; korner yarışı / N. korner yalnız resmî korner sırasını düzenli tam veren liglerde — maç bazında settle alanına bakın), tenis ~%95, buz hokeyi ~%88, voleybol ~%76, masa tenisi ~%70, e-spor ~%60, kriket ~%40–60 |
| Sonucu olmayan | settle: false marketler çoğunlukla kaynağın yayımlamadığı maç içi istatistiklerdir: tenis/masa tenisi/voleybol/hokeyde "ilk N'e ulaşan", kriket top-top ve oyuncu marketleri, e-spor kill/hedef marketleri (ilk kan, Baron, ejderha…) |
| Golcü | futbol — gol atar / 2+ / 3+ gol, gol veya asist, ilk / son / ikinci golcü — maç öncesi ve canlı — maçın gol listesini izlediğimiz maçlarda settle: true; sonuç bitiş düdüğünden yaklaşık 20–30 dk sonra gelir. Goller oyuncuya resmî kadro üzerinden bağlanır ve resmî skorla çapraz kontrol edilir; oynamayan veya kadroda doğrulanamayan oyuncu void. Kendi kalesine gol hiçbir oyuncuya sayılmaz; kendi kalesine gol olan maçta ilk/son/ikinci golcü void. Yarı golcü marketleri settle: false. |
| Betradar ID | kaynakta yok |
Sık yapılan hatalar
| Belirti | Neden & çözüm |
|---|---|
| “Oranlar sadece 2–3 sn’de bir güncelleniyor” | Zamanlayıcıyla poll yapıyorsunuz. Akışı kullanın — her değişikliği ~0,5 sn'de iter. Bkz. Canlı oran güncellemesi. |
| “Oranlar durdu / dondu” | odds_change gelmemesi oranın hareket etmediği anlamına gelir. Canlılık için alive'ı (10 sn) izleyin; tek bir frozen: true seçenek anlık askıdır, bloke değil. |
| Her çağrı 403 dönüyor | IP whitelist boş ya da sunucu IP'niz listede değil — panelden ekleyin (Entegrasyon → İzinli IP'ler). Veya Veri API henüz açık değil (feed_disabled). |
| Yanıtlar çok büyük / yavaş | Accept-Encoding: gzip gönderin (curl --compressed). /fixtures'i bir kez çekip sonra akışı dinleyin — döngüyle tekrar çekmeyin. |
| Oranlar yanlış sütunda görünüyor (1 / X / 2) | Seçenekleri outcomes dizisindeki sırasına göre yerleştiriyorsunuz. Fiyatı olmayan seçenek listede yer almaz (ör. 0–2'de deplasman galibiyeti çekilmiş olabilir; geriye yalnız ev sahibi ve beraberlik kalır), bu yüzden sıra kayar. Her zaman type alanına göre yerleştirin (1X2: 0 = ev sahibi, 1 = beraberlik, 3 = deplasman); eksik tür için kilit gösterin. |
| Kapanan çizgi / eski oran ekranda kalıyor | odds_change geldiğinde değişen her key için elinizdeki tüm satırları mesajdakilerle değiştirin ve removed listesindeki anahtarları silin. Liste sırasına göre birleştirmeyin. |
| Sonuçlar bahislerime uymuyor | Bahsi sonuçtan farklı anahtarladınız. Tam seçenek demetini saklayıp eşleştirin: maç id + key + params + type + values. |
| Reconnect sonrası mesaj kaçtı | ?session=&since=<sonSeq> ile bağlanın (5 dk replay). resync_required gelirse /fixtures + /results?since= ile tazeleyin. |
| 429 too_many_connections | Hesap başına en fazla 5 akış bağlantısı, 1200 REST istek/dk. Tek akış yeter — gereken maçlara abone olun. |
| Tarayıcı WebSocket kimlik doğrulayamıyor | El sıkışma Authorization başlığı ister; tarayıcı sokete başlık koyamaz. Akışı sunucuda çalıştırın. |
| Betradar ID bekliyorum | Kaynakta yok — bizim sabit id'lerimiz ve seçenek demeti üzerinden eşleştirin. |
Hata bildirimi & sorumluluk
Sistemimizden kaynaklandığını düşündüğünüz bir hata (yanlış oran, yanlış ya da eksik sonuç, hatalı market verisi vb.) fark ettiğinizde bize bildirmeniz yeterlidir.
- Bildirim süresi: hatanın oluştuğu andan itibaren en geç 24 saat. Bildirimde ilgili maç kimlikleri, market ve seçenek bilgisi ile kısa bir açıklama iletin.
- Telafi: süresi içinde bildirilen ve incelememizde bizden kaynaklandığı doğrulanan hatalarda oluşan net kaybınız, kullandığınız pakete göre hesabınıza tanımlanır: GGR paketi kullanıyorsanız GGR kredisi, abonelik paketi kullanıyorsanız abonelik süresi olarak. Nakit iade yapılmaz.
- Net kayıp: hatadan yararlanan oyunculardan geri alınabilen tutarlar düşüldükten sonra kalan tutardır. Bir hatanın bilerek ve tekrar tekrar kullanıldığı durumlarda ilgili ödemeleri oyunculardan geri almanızı bekleriz.
- Zamanında (24 saat içinde) bildirilmeyen hatalardan doğan kayıplar için sorumluluk kabul edilmez.