UZSL Live API v1

To‘liq hujjat: GraphQL (Hudl/StatsBomb shape) + REST. Graphics: faqat api_url, client_id, client_secret. Ma’lumot: live eventlar (~3s) → memory → API (request pathda SB dump yo‘q).

1. Faqat shuni almashtiring

'api_url' => "https://dostats.uzsl.uz/apiv1/v1/",
'client_id' => "<from admin>",
'client_secret' => "<from admin>",

Aliaslar: POST /v1/token = POST /token; POST /v1/graphql = POST /graphql (apiv1 prefix bilan).

2. Live ma’lumot oqimi

StatsBomb events (~3s tick)
  → MatchTracker memory
     ├─ team stats  → GraphQL live_team_match_aggregated_stat · REST /broadcast · /stats
     ├─ player panel → REST /admin/explore/.../players/{id}
     └─ async SQLite (events, match_stats, player_match_stats)

• Live: javob memory’dan (~ms), raqamlar o‘yin davomida yangilanadi
• Tugagan: SQLite
• live_player_match_aggregated_stat to‘liq dump SB da timeout — lokalda eventlardan hisob

3. Auth

curl -X POST https://dostats.uzsl.uz/apiv1/v1/token \
  -H 'content-type: application/json' \
  -d '{"client_id":"YOUR_ID","client_secret":"YOUR_SECRET"}'
# → { "access_token":"uzsl_…", "token_type":"Bearer", "expires_in":86400 }

4. GraphQL (lokal)

Default GRAPHQL_MODE=local. Upstream majburiy: header X-GraphQL-Upstream: 1.

Boshqa rootlar (lineup, player agg, …): upstream header yoki REST Explorer.

4.1 Competition / season

query {
  live_competition_season {
    competition_id
    competition_name
    season_id
    season_name
  }
}

4.2 Matches

query Matches {
  live_match(
    where: { competition_id: { _eq: 1839 }, season_id: { _eq: 316 } }
    order_by: { match_date: desc }
    limit: 20
  ) {
    match_id match_name match_date match_local_kick_off
    match_home_team_id match_home_team_name
    match_away_team_id match_away_team_name
    match_home_score match_away_score match_play_status
    competition_id season_id
  }
}

4.3 Events

query MatchEvents($match_id: Int!) {
  live_match_event(
    where: { match_id: { _eq: $match_id } }
    order_by: { index: asc }
    limit: 1000
  ) {
    id match_id name type outcome
    team_id player_id
    period minute second timestamp index
    xg key_pass card advantage
    updated_at
  }
}

query EventCount($match_id: Int!) {
  live_match_event_aggregate(where: { match_id: { _eq: $match_id } }) {
    aggregate { count }
  }
}

4.4 Team aggregated stats (Hudl)

query TeamAgg($mid: Int!) {
  live_team_match_aggregated_stat(where: { match_id: { _eq: $mid } }) {
    match_id team_id stat_name value
  }
}

Filter: stat_name: { _eq: "xg" } yoki team_id: { _eq: … }.

4.5 curl

curl -X POST https://dostats.uzsl.uz/apiv1/v1/graphql \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  -d '{"query":"query { live_competition_season { competition_id season_id } }"}'

{
  "operationName": "Matches",
  "variables": {},
  "query": "query Matches { live_match(limit: 5) { match_id match_name } }"
}

5. REST API

Swagger: /docs · JSON katalog: /endpoints · Auth: X-API-Key

5.1 Public / health

5.2 Graphics

5.3 Matches & live

curl -H "X-API-Key: KEY" \
  http://uzstats.uzsl.uz/apiv1/matches/1453630/stats

curl -H "X-API-Key: KEY" \
  http://uzstats.uzsl.uz/apiv1/broadcast/1453630/stats

5.4 Admin

6. Match Explorer (REST + UI)

UI: /admin/explore · Auth: admin token / API key

Player panel maydonlari

Goals, Total xG, Average xG per shot, Shots, Shots On Target, Assists, Key Passes, Possession, Passes, Successful Dribbles, Pass Completion %, Fouls Committed, Yellow / Second Yellow / Red Cards, Offsides, Corners. Javobda panel[] + source (memory|sqlite|events) + tracking.

7. Checklist — graphics

1. Admin → Graphics client → client_id / client_secret
2. api_url = UZ yoki DO …/apiv1/v1/
3. Kod: token + graphql o‘zgarmasin
4. Team stats: live_team_match_aggregated_stat yoki /broadcast/{id}/stats
5. Player panel: Explorer yoki explore REST (SB player dump emas)

README (server): repo README.md · StatsBomb guide: live-data-api-guide.statsbomb.com