Atletas

Operações relacionadas a atletas

Detalhes de um jogador

get

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

Autorizações
Parâmetros de rota
jogador_idstringObrigatório

ID do jogador. Exemplo: 10

Example: 10
Respostas
200

Detalhes do jogador

application/json
get
GET /api/v1/atletas/{jogador_id} HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*

{
  "jogador_id": 10,
  "nome": "Neymar",
  "nome_completo": "Neymar da Silva Santos Júnior",
  "data_nascimento": "1992-02-05",
  "idade": 32,
  "nacionalidade": "Brasil",
  "altura": 175,
  "peso": 68,
  "posicao": "Atacante",
  "foto": "https://jogadores.com/neymar.png",
  "time_atual": {
    "time_id": 5,
    "nome": "Al Hilal",
    "escudo": "https://escudos.com/alhilal.png"
  },
  "numero_camisa": 10,
  "pe_preferido": "direito"
}

Estatísticas do atleta

get

Retorna estatísticas detalhadas de um atleta, podendo filtrar por jogador, time, competição e temporada.

Autorizações
Parâmetros de consulta
jogador_idstringOpcional

ID do atleta. Exemplo: 10

Example: 10
time_idstringOpcional

ID do time. Exemplo: 3

Example: 3
competicao_idstringOpcional

ID da competição. Exemplo: 1

Example: 1
temporadastringOpcional

Ano/temporada. Exemplo: 2024

Example: 2024
Respostas
200

Estatísticas detalhadas do atleta

application/json
Respostaobject
get
GET /api/v1/atletas/estatisticas HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*
200

Estatísticas detalhadas do atleta

{
  "jogador_id": 10,
  "nome": "Neymar",
  "temporada": 2024,
  "time": "Al Hilal",
  "gols": 8,
  "assistencias": 3,
  "jogos": 10,
  "minutos_jogados": 900,
  "cartoes_amarelos": 1,
  "cartoes_vermelhos": 0
}

Busca de jogadores

get

Busca jogadores por nome, time ou nacionalidade.

Autorizações
Parâmetros de consulta
nomestringOpcional

Nome do jogador (ou parte do nome). Exemplo: Neymar

Example: Neymar
time_idstringOpcional

ID do time. Exemplo: 3

Example: 3
nacionalidadestringOpcional

Nacionalidade do jogador. Exemplo: Brasil

Example: Brasil
posicaostringOpcional

Posição do jogador. Exemplo: Atacante

Example: Atacante
Respostas
200

Lista de jogadores que correspondem aos critérios de busca

application/json
get
GET /api/v1/atletas/busca HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*
200

Lista de jogadores que correspondem aos critérios de busca

[
  {
    "jogador_id": 10,
    "nome": "Neymar",
    "posicao": "Atacante",
    "idade": 32,
    "nacionalidade": "Brasil",
    "time_atual": {
      "time_id": 5,
      "nome": "Al Hilal",
      "escudo": "https://escudos.com/alhilal.png"
    },
    "foto": "https://jogadores.com/neymar.png"
  },
  {
    "jogador_id": 11,
    "nome": "Pedro",
    "posicao": "Atacante",
    "idade": 26,
    "nacionalidade": "Brasil",
    "time_atual": {
      "time_id": 3,
      "nome": "Flamengo",
      "escudo": "https://escudos.com/flamengo.png"
    },
    "foto": "https://jogadores.com/pedro.png"
  }
]

Perfil do atleta

get

Retorna o perfil detalhado de um atleta, podendo filtrar por id, nome ou página.

Autorizações
Parâmetros de consulta
idstringOpcional

ID do atleta. Exemplo: 10

Example: 10
paramsstringOpcional

Busca por nome do atleta. Exemplo: Neymar

Example: Neymar
pageintegerOpcional

Número da página para paginação. Exemplo: 1

Example: 1
Respostas
200

Perfil detalhado do atleta

application/json
Respostaobject
get
GET /api/v1/atletas/perfil HTTP/1.1
Host: api.sportmetrics.com.br
Authorization: Bearer API_TOKEN
Accept: */*
200

Perfil detalhado do atleta

{
  "jogador_id": 10,
  "nome": "Neymar",
  "idade": 32,
  "nacionalidade": "Brasil",
  "posicao": "Atacante",
  "foto": "https://jogadores.com/neymar.png",
  "time_atual": {
    "time_id": 5,
    "nome": "Al Hilal",
    "escudo": "https://escudos.com/alhilal.png"
  },
  "estatisticas": {
    "gols": 8,
    "assistencias": 3,
    "jogos": 10
  }
}
AnteriorTimesPróximoModels