Jogadores

Endpoint: /wp-json/sportspress/v2/players

Definições de Campos

Campos de Identificação e Publicação

Campo	Descrição
`id`	Identificador único para o objeto (inteiro, somente leitura)
`guid`	Identificador globalmente único (somente leitura)
`slug`	Identificador alfanumérico amigável para URL único para seu tipo
`link`	URL para o objeto (somente leitura)
`date`	Timestamp de publicação no fuso horário do site (ISO 8601)
`date_gmt`	Data de publicação em GMT (ISO 8601)
`modified`	Data da última modificação no fuso horário do site (somente leitura)
`modified_gmt`	Data da última modificação em GMT (somente leitura)
`status`	Estado de publicação; um de `publish`, `future`, `draft`, `pending` ou `private`

Campos de Conteúdo e Metadados

Campo	Descrição
`title`	O nome do jogador
`content`	A biografia ou descrição do jogador
`excerpt`	Um breve resumo do jogador
`featured_media`	O ID da foto do jogador (imagem em destaque)
`author`	O ID da conta de usuário do criador

Campos de Status e Acesso

Campo	Descrição
`password`	Uma senha para proteger o acesso ao conteúdo e resumo
`comment_status`	Se os comentários estão abertos ou não; `open` ou `closed`
`ping_status`	Se o objeto pode ser pingado ou não; `open` ou `closed`
`menu_order`	A ordem do objeto em relação a outros objetos do mesmo tipo

Campos de Taxonomia

Campo	Descrição
`leagues`	Os termos atribuídos ao objeto na taxonomia de liga (array de IDs de termo)
`seasons`	Os termos atribuídos ao objeto na taxonomia de temporada (array de IDs de termo)
`positions`	Os termos atribuídos ao objeto na taxonomia de posição (array de IDs de termo)

Campos Específicos de Jogador

Campo	Descrição
`number`	O número de camisa do jogador (inteiro)
`nationalities`	Códigos de país de 3 letras para as nacionalidades do jogador (array de strings)
`teams`	Os IDs de todos os times com os quais o jogador é afiliado (array — atuais e anteriores)
`current_teams`	Os IDs das afiliações de time atuais ativas do jogador (array)
`past_teams`	Os IDs das afiliações de time históricas do jogador (array)
`metrics`	Medições de desempenho do jogador (valores estáticos como altura, peso)
`statistics`	Dados de desempenho baseados em liga e temporada (valores calculados)

A maioria dos campos suporta múltiplos contextos (view, edit, embed), controlando visibilidade e permissões de modificação em diferentes cenários de acesso à API.

Limitação Conhecida

Jogadores criados via REST API podem não aparecer automaticamente nas listas de jogadores. Esta é uma lacuna conhecida documentada no fórum de suporte. Após criar um jogador via API, verifique se o jogador está atribuído ao time correto no admin do WordPress, e que a lista de jogadores está configurada para incluir jogadores desse time.

Exemplos de Requisições

Listar Todos os Jogadores

GET /wp-json/sportspress/v2/players

Recuperar um Único Jogador

GET /wp-json/sportspress/v2/players/55

Criar um Jogador

POST /wp-json/sportspress/v2/players
Content-Type: application/json{
  "title": "John Smith",
  "status": "publish",
  "number": 10,
  "nationalities": ["eng"],
  "current_teams": [10],
  "leagues": [5],
  "seasons": [3],
  "positions": [7]
}

Atualizar Métricas do Jogador

PUT /wp-json/sportspress/v2/players/55
Content-Type: application/json{
  "metrics": {
    "height": "180",
    "weight": "75"
  }
}

Nota: Atualizar métricas de jogadores via REST API requer o SportsPress Pro 2.7.3 ou posterior.

Filtrar Jogadores por Liga e Temporada

GET /wp-json/sportspress/v2/players?leagues=5&seasons=3

A filtragem do endpoint de lista de jogadores foi adicionada no SportsPress Pro 2.5.5.