{"openapi":"3.1.0","info":{"title":"FragPredict API","description":"Profesyonel CS2 maçlarında harita dizilimi, harita ve seri tahmini.","version":"1.0.0"},"paths":{"/health":{"get":{"tags":["Durum"],"summary":"Servis durumu","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/teams":{"get":{"tags":["Veri"],"summary":"Takımlar","description":"Takım seçimi için güncel takım listesi. Tahmin isteklerindeki takım adları buradaki yazımla aynı olmalı.","operationId":"list_teams_api_v1_teams_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamsResponse"}}}}}}},"/api/v1/maps":{"get":{"tags":["Veri"],"summary":"Haritalar","description":"Aktif harita havuzu. Harita adları tahmin isteklerinde buradaki yazımla verilmeli.","operationId":"list_maps_api_v1_maps_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapsResponse"}}}}}}},"/api/v1/model":{"get":{"tags":["Veri"],"summary":"Model bilgisi","description":"Modelin eğitildiği veri aralığı ve eğitimde görmediği dönemde ölçülen başarısı.","operationId":"model_info_api_v1_model_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelInfoResponse"}}}}}}},"/api/v1/predict-series":{"post":{"tags":["Tahmin"],"summary":"Seri ve harita dizilimi","description":"İki takım ve format verildiğinde hangi haritaların geleceğini, her haritayı hangi takımın kazanacağını ve seriyi kimin alacağını tahmin eder. `maps` verilirse modelin dizilimi yerine o haritalar kullanılır. Seri olasılığı, haritalar arasındaki bağımlılığı hesaba katar: iki takımın o günkü durumu bütün haritalara ortak yansır, bu yüzden 2-0 / 0-2 skorları haritalar bağımsız olsaydı olacağından daha olasıdır. Takımların sırası sonucu değiştirmez.","operationId":"predict_series_api_v1_predict_series_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeriesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predict":{"post":{"tags":["Tahmin"],"summary":"Tek harita","description":"Haritası belli bir maçta iki takımın kazanma olasılığı. Takımların sırası sonucu değiştirmez.","operationId":"predict_match_api_v1_predict_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Servis çalışıyorsa `ok`."},"predictor_loaded":{"type":"boolean","title":"Predictor Loaded","description":"Model yüklü mü."},"supabase_connected":{"type":"boolean","title":"Supabase Connected","description":"Tahmin kaydı açık mı."}},"type":"object","required":["status","predictor_loaded","supabase_connected"],"title":"HealthResponse"},"LineupMap":{"properties":{"map":{"type":"string","title":"Map","description":"Harita."},"role":{"type":"string","enum":["pick","decider"],"title":"Role","description":"`pick` ya da `decider`. Bo1'deki tek harita banlardan kalan haritadır ve `decider` sayılır."},"in_veto_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"In Veto Probability","description":"Haritanın vetodan çıkma (seçilme ya da decider kalma) olasılığı; Bo1'de banlardan sonra kalma olasılığı. Harita veto havuzunda değilse `null`."},"team1_win_probability":{"type":"number","title":"Team1 Win Probability","description":"Bu haritada team1'in kazanma olasılığı (0–1). Seri başlamadan önceki tahmin; tek harita tahminiyle (`/api/v1/predict`) aynı. Aynı serinin haritaları birbirinden bağımsız değil (iki takımın o günkü durumu her haritaya yansır): decider ancak seri 1-1'e gelirse oynanır ve o durumda decider'ı kazanma olasılığı bu değerden farklıdır. Seri ve skor olasılıkları bunu hesaba katar."}},"type":"object","required":["map","role","in_veto_probability","team1_win_probability"],"title":"LineupMap"},"MapProbability":{"properties":{"map":{"type":"string","title":"Map","description":"Harita."},"played_probability":{"type":"number","title":"Played Probability","description":"Haritanın bu seride oynanma olasılığı. Decider ancak seri son haritaya kalırsa oynanır."},"in_veto_probability":{"type":"number","title":"In Veto Probability","description":"Haritanın vetodan çıkma (seçilme ya da decider kalma) olasılığı."},"team1_win_probability":{"type":"number","title":"Team1 Win Probability","description":"Bu haritada team1'in kazanma olasılığı (0–1). Seri başlamadan önceki tahmin; tek harita tahminiyle (`/api/v1/predict`) aynı. Aynı serinin haritaları birbirinden bağımsız değil (iki takımın o günkü durumu her haritaya yansır): decider ancak seri 1-1'e gelirse oynanır ve o durumda decider'ı kazanma olasılığı bu değerden farklıdır. Seri ve skor olasılıkları bunu hesaba katar."}},"type":"object","required":["map","played_probability","in_veto_probability","team1_win_probability"],"title":"MapProbability"},"MapsResponse":{"properties":{"count":{"type":"integer","title":"Count","description":"Harita sayısı."},"maps":{"items":{"type":"string"},"type":"array","title":"Maps","description":"Aktif harita havuzu: son 60 günde oynanmış haritalar, alfabetik."},"as_of":{"type":"string","title":"As Of","description":"Havuzun hesaplandığı tarih (verideki son maç), YYYY-AA-GG."}},"type":"object","required":["count","maps","as_of"],"title":"MapsResponse"},"ModelInfoResponse":{"properties":{"model":{"type":"string","title":"Model","description":"Harita tahmin modeli."},"data_from":{"type":"string","title":"Data From","description":"Eğitim verisinin başlangıç tarihi."},"data_to":{"type":"string","title":"Data To","description":"Eğitim verisinin bitiş tarihi."},"test_from":{"type":"string","title":"Test From","description":"Değerlendirme döneminin başlangıcı."},"test_to":{"type":"string","title":"Test To","description":"Değerlendirme döneminin bitişi."},"test_metrics":{"additionalProperties":{"type":"number"},"type":"object","title":"Test Metrics","description":"Modelin eğitimde görmediği değerlendirme döneminde harita başına ölçülen metrikler (`roc_auc`, `log_loss`, `brier_score`, `accuracy_at_0.5`)."}},"type":"object","required":["model","data_from","data_to","test_from","test_to","test_metrics"],"title":"ModelInfoResponse"},"PredictRequest":{"properties":{"team1":{"type":"string","title":"Team1","description":"Birinci takım. `GET /api/v1/teams` listesindeki yazımla aynı olmalı.","examples":["Team Vitality"]},"team2":{"type":"string","title":"Team2","description":"İkinci takım. `GET /api/v1/teams` listesindeki yazımla aynı olmalı.","examples":["Natus Vincere"]},"map":{"type":"string","title":"Map","description":"Harita. `GET /api/v1/maps` listesindeki aktif havuzdan olmalı.","examples":["Mirage"]},"tier":{"type":"string","title":"Tier","description":"Maçın seviyesi: `tier1`, `tier2` ya da `tier3`.","default":"tier1","examples":["tier1"]},"best_of":{"type":"integer","title":"Best Of","description":"Seri formatı: 1, 3 ya da 5.","default":3,"examples":[3]}},"type":"object","required":["team1","team2","map"],"title":"PredictRequest"},"PredictResponse":{"properties":{"team1":{"type":"string","title":"Team1","description":"İstekteki birinci takım."},"team2":{"type":"string","title":"Team2","description":"İstekteki ikinci takım."},"map":{"type":"string","title":"Map","description":"Harita."},"tier":{"type":"string","title":"Tier","description":"İstekteki seviye."},"best_of":{"type":"integer","title":"Best Of","description":"İstekteki format."},"team1_win_probability":{"type":"number","title":"Team1 Win Probability","description":"Bu haritada team1'in kazanma olasılığı (0–1)."},"team2_win_probability":{"type":"number","title":"Team2 Win Probability","description":"1 − team1_win_probability."},"predicted_winner":{"type":"string","title":"Predicted Winner","description":"Kazanma olasılığı yüksek olan takım."},"model":{"type":"string","title":"Model","description":"Tahmini üreten model."},"model_version":{"type":"string","title":"Model Version","description":"Harita modelinin sürümü (özellik seti ve güç puanı); model değişince değişir."},"logged_to_db":{"type":"boolean","title":"Logged To Db","description":"Tahmin, modelin başarısını ölçmek için kaydedildi mi. IP ya da kişisel bilgi tutulmaz; aynı maç kısa sürede tekrar sorulursa kayıt atlanır."}},"type":"object","required":["team1","team2","map","tier","best_of","team1_win_probability","team2_win_probability","predicted_winner","model","model_version","logged_to_db"],"title":"PredictResponse"},"ScoreProbability":{"properties":{"score":{"type":"string","title":"Score","description":"Seri skoru, team1–team2 sırasıyla; örneğin `2-1`."},"probability":{"type":"number","title":"Probability","description":"Bu skorla bitme olasılığı."}},"type":"object","required":["score","probability"],"title":"ScoreProbability"},"SeriesOutcome":{"properties":{"team1_win_probability":{"type":"number","title":"Team1 Win Probability","description":"Seride team1'in kazanma olasılığı (0–1). Seri olasılığı, haritalar arasındaki bağımlılığı hesaba katar: iki takımın o günkü durumu bütün haritalara ortak yansır, bu yüzden 2-0 / 0-2 skorları haritalar bağımsız olsaydı olacağından daha olasıdır."},"team2_win_probability":{"type":"number","title":"Team2 Win Probability","description":"1 − team1_win_probability."},"predicted_winner":{"type":"string","title":"Predicted Winner","description":"Seriyi kazanma olasılığı yüksek olan takım."},"score_probabilities":{"items":{"$ref":"#/components/schemas/ScoreProbability"},"type":"array","title":"Score Probabilities","description":"Olası seri skorları; haritalar arasındaki bağımlılık hesaba katılarak."}},"type":"object","required":["team1_win_probability","team2_win_probability","predicted_winner","score_probabilities"],"title":"SeriesOutcome"},"SeriesRequest":{"properties":{"team1":{"type":"string","title":"Team1","description":"Birinci takım. `GET /api/v1/teams` listesindeki yazımla aynı olmalı.","examples":["Team Vitality"]},"team2":{"type":"string","title":"Team2","description":"İkinci takım. `GET /api/v1/teams` listesindeki yazımla aynı olmalı.","examples":["Natus Vincere"]},"best_of":{"type":"integer","title":"Best Of","description":"Seri formatı: 1, 3 ya da 5.","default":3,"examples":[3]},"maps":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Maps","description":"İsteğe bağlı. Verilmezse haritaları model seçer. Elle dizilim için Bo1'de 1, Bo3'te 3, Bo5'te 5 farklı harita: önce pick'ler, en sonda decider; örneğin `[\"Mirage\", \"Inferno\", \"Nuke\"]`. Haritalar aktif havuzdan olmalı.","examples":[null,["Mirage","Inferno","Nuke"]]}},"type":"object","required":["team1","team2"],"title":"SeriesRequest"},"SeriesResponse":{"properties":{"team1":{"type":"string","title":"Team1","description":"İstekteki birinci takım."},"team2":{"type":"string","title":"Team2","description":"İstekteki ikinci takım."},"best_of":{"type":"integer","title":"Best Of","description":"İstekteki format."},"lineup_source":{"type":"string","enum":["model","manual"],"title":"Lineup Source","description":"`model`: haritaları model seçti. `manual`: istekteki `maps` kullanıldı."},"lineup":{"items":{"$ref":"#/components/schemas/LineupMap"},"type":"array","title":"Lineup","description":"Gelecek haritalar: önce pick'ler, en sonda decider. Pick'lerin oynanma sırası tahmin edilmez."},"lineup_probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lineup Probability","description":"Bu harita kümesinin (sırası önemsiz) birlikte gelme olasılığı. Elle verilen haritalardan biri veto havuzunda değilse `null`."},"series":{"$ref":"#/components/schemas/SeriesOutcome","description":"`lineup`'taki haritalar oynanırsa seri sonucu."},"series_overall":{"$ref":"#/components/schemas/SeriesOutcome","description":"Haritalar henüz belli değilken seri sonucu: olası bütün dizilimlerin olasılıklarıyla ağırlıklı ortalama."},"maps":{"items":{"$ref":"#/components/schemas/MapProbability"},"type":"array","title":"Maps","description":"Veto havuzundaki her harita, gelme olasılığına göre sıralı."},"model":{"type":"string","title":"Model","description":"Tahmini üreten modeller."},"model_version":{"type":"string","title":"Model Version","description":"Harita modelinin sürümü (özellik seti ve güç puanı); model değişince değişir."},"logged_to_db":{"type":"boolean","title":"Logged To Db","description":"Tahmin, modelin başarısını ölçmek için kaydedildi mi. IP ya da kişisel bilgi tutulmaz; aynı maç kısa sürede tekrar sorulursa kayıt atlanır."}},"type":"object","required":["team1","team2","best_of","lineup_source","lineup","lineup_probability","series","series_overall","maps","model","model_version","logged_to_db"],"title":"SeriesResponse"},"TeamsResponse":{"properties":{"count":{"type":"integer","title":"Count","description":"Takım sayısı."},"teams":{"items":{"type":"string"},"type":"array","title":"Teams","description":"Verideki son maçtan geriye 120 gün içinde maça çıkmış takımlar, alfabetik. Tahmin uç noktaları verideki daha eski takımları da kabul eder."}},"type":"object","required":["count","teams"],"title":"TeamsResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"Tahmin","description":"Maç ve seri tahminleri."},{"name":"Veri","description":"Tahmin isteklerinde kullanılacak takım ve harita adları, model bilgisi."},{"name":"Durum","description":"Servisin çalışıp çalışmadığı."}]}