Kayıt

— Telgraf protokolü —

Public API

Kasaba'dan veri çekmek isteyen kovboylar için. Edge cache'li, rate-limited, açık şema.

Authorization

Public uçlar (opportunities, sinyaller, leaderboard) açık. State-changing uçlar (duello pick, arena post) için Authorization: Bearer <jwt> ya da httpOnly cookie auth gerek.

GET /api/opportunities?date=today

Bugünün analiz edilmiş maçları. date parametresi: today, yesterday, tomorrow, day_after_tomorrow ya da YYYY-MM-DD.

{
  opportunities: [
    {
      id: "uuid",
      "Ev Sahibi": "Fenerbahçe",
      "Deplasman": "Galatasaray",
      "Lig": "Süper Lig",
      best_prediction: "MS 2.5 ÜST",
      best_confidence: 82,
      kelly_stake: 3.2,
      ...
    }
  ]
}

GET /api/telegram/signals?limit=50

Son N kanal sinyali. Edge cache 15s. Kind'lar: opportunity, entry, hot, live_hit, result_won, result_lost, duello_seed, duello_settle.

GET /api/duello/weekly

Aktif düello haftası + 5 maç + Kahin'in maskelenmemiş skorları (kickoff sonrası açık). Auth'lu çağrılarda userPicks da döner.

Rate limit

Read-only public uçlar 60 req/dk/IP, write uçlar 20 req/dk/IP. Bunu aşarsan 429 yer telgraf.