Skip to main content
GET
/
v1
/
jogadores
Buscar jogadores por nome
curl --request GET \
  --url http://localhost:8000/api/v1/jogadores
{
  "data": [
    {
      "id": 1,
      "nome_popular": "Pedro",
      "nome": "Pedro Guilherme",
      "idade": 27,
      "posicao": {
        "nome": "Atacante",
        "sigla": "ATA"
      },
      "numero_camisa": 9,
      "gols": 15,
      "time": {
        "id": 1,
        "nome": "Flamengo",
        "sigla": "FLA",
        "escudo_url": null
      }
    }
  ],
  "meta": {
    "total": 5
  }
}

Query Parameters

q
string
required

Busca parcial pelo nome do jogador (mínimo 2 caracteres, case-insensitive)

Minimum string length: 2
Example:

"Pedro"

time_id
integer

Restringe a busca a um time específico

Example:

1

posicao
enum<string>

Filtra por posição

Available options:
goleiro,
zagueiro,
lateral,
volante,
meia,
atacante

Response

Lista de jogadores encontrados (máximo 20)

data
object[]
meta
object