Campeonatos | API SPORT METRICS

Lista de campeonatos

get

Retorna a lista de todos os campeonatos disponíveis. Permite filtrar por país e tipo de campeonato.

Autorizações

Parâmetros de consulta

paisstringOpcional

Filtrar campeonatos por país. Exemplo: Brasil

Example: Brasil

tipostring · enumOpcional

Filtrar campeonatos por tipo (liga, copa, etc). Exemplo: liga

Example: ligaValores possíveis:

Respostas

200

Lista de campeonatos disponíveis

application/json

429

Limite de requisições excedido

application/json

500

Erro interno do servidor

application/json

get

GET /api/v1/campeonatos HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

[
  {
    "campeonato_id": 1,
    "nome": "Brasileirão Série A",
    "tipo": "liga",
    "bandeira_pais": "https://flags.com/br.png",
    "escudo": "https://escudos.com/brasileirao.png",
    "pais": "Brasil",
    "sigla_pais": "BR",
    "_link": "/v1/campeonatos/1/2024"
  }
]

Detalhes de um campeonato

get

Retorna informações detalhadas sobre um campeonato específico.

Autorizações

Parâmetros de rota

competicao_idstringObrigatório

ID do campeonato. Exemplo: 1

Example: 1

anostringObrigatório

Ano/temporada do campeonato. Exemplo: 2024

Example: 2024

Respostas

200

Detalhes do campeonato específico

application/json

404

Campeonato não encontrado

application/json

get

GET /api/v1/campeonatos/{competicao_id}/{ano} HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "campeonato_id": 1,
  "nome": "Brasileirão Série A",
  "tipo": "liga",
  "temporada": 2024,
  "data_inicio": "2024-04-10",
  "data_fim": "2024-12-08",
  "pais": "Brasil",
  "escudo": "https://escudos.com/brasileirao.png",
  "times_participantes": 20,
  "rodadas": 38,
  "formato": "pontos corridos",
  "campeao_anterior": {
    "time_id": 2,
    "nome": "Palmeiras",
    "escudo": "https://escudos.com/palmeiras.png"
  },
  "campeao_atual": {
    "time_id": 3,
    "nome": "Flamengo",
    "escudo": "https://escudos.com/flamengo.png"
  },
  "url_transmissao": "https://transmissao.com/brasileirao"
}

Tabela de classificação

get

Retorna a tabela de classificação de um campeonato específico.

Autorizações

Parâmetros de rota

competicao_idstringObrigatório

ID do campeonato. Exemplo: 1

Example: 1

anostringObrigatório

Ano/temporada do campeonato. Exemplo: 2024

Example: 2024

Respostas

200

Tabela de classificação do campeonato

application/json

404

Tabela da competição não encontrada

application/json

get

GET /api/v1/campeonatos/{competicao_id}/{ano}/tabela HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "campeonato_id": 1,
  "temporada": 2024,
  "nome_campeonato": "Brasileirão Série A",
  "rodada_atual": 10,
  "classificacao": [
    {
      "posicao": 1,
      "time_id": 3,
      "nome": "Flamengo",
      "escudo": "https://escudos.com/flamengo.png",
      "pontos": 24,
      "jogos": 10,
      "vitorias": 7,
      "empates": 3,
      "derrotas": 0,
      "gols_pro": 20,
      "gols_contra": 8,
      "saldo_gols": 12,
      "aproveitamento": 80,
      "ultimos_jogos": [
        "V",
        "E",
        "V",
        "V",
        "V"
      ]
    },
    {
      "posicao": 2,
      "time_id": 2,
      "nome": "Palmeiras",
      "escudo": "https://escudos.com/palmeiras.png",
      "pontos": 22,
      "jogos": 10,
      "vitorias": 7,
      "empates": 1,
      "derrotas": 2,
      "gols_pro": 18,
      "gols_contra": 10,
      "saldo_gols": 8,
      "aproveitamento": 73.3,
      "ultimos_jogos": [
        "V",
        "D",
        "V",
        "E",
        "V"
      ]
    }
  ]
}

Rodadas do campeonato

get

Retorna a lista de todas as rodadas de um campeonato.

Autorizações

Parâmetros de rota

competicao_idstringObrigatório

ID do campeonato. Exemplo: 1

Example: 1

anostringObrigatório

Ano/temporada do campeonato. Exemplo: 2024

Example: 2024

Respostas

200

Lista de rodadas do campeonato

application/json

404

Rodadas não encontradas

application/json

get

GET /api/v1/campeonatos/{competicao_id}/{ano}/rodadas HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "campeonato_id": 1,
  "temporada": 2024,
  "rodadas": [
    {
      "rodada": "1",
      "data_inicio": "2024-04-10",
      "data_fim": "2024-04-12",
      "status": "finalizada",
      "partidas": [
        {
          "partida_id": 1001,
          "data_hora": "2024-04-10T19:00:00Z",
          "estadio": "Maracanã",
          "cidade": "Rio de Janeiro",
          "time_mandante": {
            "time_id": 3,
            "nome": "Flamengo",
            "sigla": "FLA",
            "escudo": "https://escudos.com/flamengo.png"
          },
          "time_visitante": {
            "time_id": 2,
            "nome": "Palmeiras",
            "sigla": "PAL",
            "escudo": "https://escudos.com/palmeiras.png"
          },
          "placar_mandante": 2,
          "placar_visitante": 1,
          "status": "finalizado"
        }
      ]
    }
  ]
}

Jogos de uma rodada específica

get

Retorna os jogos de uma rodada específica do campeonato.

Autorizações

Parâmetros de rota

competicao_idstringObrigatório

ID do campeonato. Exemplo: 1

Example: 1

anostringObrigatório

Ano/temporada do campeonato. Exemplo: 2024

Example: 2024

roundstringObrigatório

Número da rodada. Exemplo: 1

Example: 1

Respostas

200

Lista de jogos da rodada

application/json

404

Rodadas não encontradas

application/json

get

GET /api/v1/campeonatos/{competicao_id}/{ano}/rodada/{round} HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "campeonato_id": 1,
  "temporada": 2024,
  "rodadas": [
    {
      "rodada": "1",
      "data_inicio": "2024-04-10",
      "data_fim": "2024-04-12",
      "status": "finalizada",
      "partidas": [
        {
          "partida_id": 1001,
          "data_hora": "2024-04-10T19:00:00Z",
          "estadio": "Maracanã",
          "cidade": "Rio de Janeiro",
          "time_mandante": {
            "time_id": 3,
            "nome": "Flamengo",
            "sigla": "FLA",
            "escudo": "https://escudos.com/flamengo.png"
          },
          "time_visitante": {
            "time_id": 2,
            "nome": "Palmeiras",
            "sigla": "PAL",
            "escudo": "https://escudos.com/palmeiras.png"
          },
          "placar_mandante": 2,
          "placar_visitante": 1,
          "status": "finalizado"
        }
      ]
    }
  ]
}

Rodada atual do campeonato

get

Retorna informações sobre a rodada atual de um campeonato.

Autorizações

Parâmetros de rota

competicao_idstringObrigatório

ID do campeonato. Exemplo: 1

Example: 1

anostringObrigatório

Ano/temporada do campeonato. Exemplo: 2024

Example: 2024

Respostas

200

Informações da rodada atual

application/json

404

Rodada atual não encontrada

application/json

get

GET /api/v1/campeonatos/{competicao_id}/{ano}/rodada/atual HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "campeonato_id": 1,
  "temporada": 2024,
  "nome_campeonato": "Brasileirão Série A",
  "rodada_atual": 10,
  "total_rodadas": 38,
  "status": "em andamento",
  "partidas": [
    {
      "partida_id": 1005,
      "data_hora": "2024-06-01T21:00:00Z",
      "estadio": "Allianz Parque",
      "cidade": "São Paulo",
      "time_mandante": {
        "time_id": 2,
        "nome": "Palmeiras",
        "sigla": "PAL",
        "escudo": "https://escudos.com/palmeiras.png"
      },
      "time_visitante": {
        "time_id": 4,
        "nome": "Corinthians",
        "sigla": "COR",
        "escudo": "https://escudos.com/corinthians.png"
      },
      "placar_mandante": 1,
      "placar_visitante": 1,
      "status": "em andamento"
    }
  ]
}

Artilheiros do campeonato

get

Retorna a lista de artilheiros do campeonato.

Autorizações

Parâmetros de rota

competicao_idstringObrigatório

ID do campeonato. Exemplo: 1

Example: 1

anostringObrigatório

Ano/temporada do campeonato. Exemplo: 2024

Example: 2024

Respostas

200

Lista de artilheiros do campeonato

application/json

404

Artilheiros não encontrados

application/json

get

GET /api/v1/campeonatos/{competicao_id}/{ano}/artilheiros HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "campeonato_id": 1,
  "temporada": 2024,
  "artilheiros": [
    {
      "jogador": {
        "id": 10,
        "nome": "Pedro",
        "primeiro_nome": "Pedro",
        "sobrenome": "Guilherme",
        "idade": 26,
        "nascimento": {
          "data": "1997-06-20",
          "local": "Rio de Janeiro",
          "pais": "Brasil"
        },
        "nacionalidade": "Brasil",
        "altura": "185",
        "peso": "80",
        "lesionado": false,
        "foto": "https://jogadores.com/pedro.png"
      },
      "estatisticas": [
        {
          "time": {
            "id": 3,
            "nome": "Flamengo",
            "logo": "https://escudos.com/flamengo.png"
          },
          "campeonato": {
            "id": 1,
            "nome": "Brasileirão Série A",
            "pais": "Brasil",
            "logo": "https://escudos.com/brasileirao.png",
            "bandeira": "https://flags.com/br.png",
            "temporada": 2024
          },
          "jogos": {
            "aparicoes": 10,
            "titular": 10,
            "minutos": 900,
            "camisa": 9,
            "posicao": "Atacante",
            "avaliacao": "7.8",
            "capitao": false
          },
          "gols": {
            "total": 8,
            "sofridos": 0,
            "assistencias": 2,
            "defesas": 0
          },
          "cartoes": {
            "amarelo": 1,
            "segundo_amarelo": 0,
            "vermelho": 0
          }
        }
      ]
    }
  ]
}