Players

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

Definizioni dei campi

Campi di identificazione e pubblicazione

Campo	Descrizione
`id`	Identificatore univoco per l'oggetto (intero, sola lettura)
`guid`	Identificatore univoco globale (sola lettura)
`slug`	Identificatore alfanumerico URL-friendly univoco per il suo tipo
`link`	URL dell'oggetto (sola lettura)
`date`	Timestamp di pubblicazione nel fuso orario del sito (ISO 8601)
`date_gmt`	Data di pubblicazione come GMT (ISO 8601)
`modified`	Data dell'ultima modifica nel fuso orario del sito (sola lettura)
`modified_gmt`	Data dell'ultima modifica come GMT (sola lettura)
`status`	Stato di pubblicazione; uno tra `publish`, `future`, `draft`, `pending` o `private`

Campi contenuto e metadati

Campo	Descrizione
`title`	Il nome del giocatore
`content`	La biografia o la descrizione del giocatore
`excerpt`	Un breve riepilogo del giocatore
`featured_media`	L'ID della foto del giocatore (immagine in primo piano)
`author`	L'ID dell'account utente del creatore

Campi stato e accesso

Campo	Descrizione
`password`	Una password per proteggere l'accesso al contenuto e all'estratto
`comment_status`	Se i commenti sono aperti o meno; `open` o `closed`
`ping_status`	Se l'oggetto può essere pingato o meno; `open` o `closed`
`menu_order`	L'ordine dell'oggetto in relazione ad altri oggetti dello stesso tipo

Campi tassonomia

Campo	Descrizione
`leagues`	I termini assegnati all'oggetto nella tassonomia league (array di ID termine)
`seasons`	I termini assegnati all'oggetto nella tassonomia season (array di ID termine)
`positions`	I termini assegnati all'oggetto nella tassonomia position (array di ID termine)

Campi specifici del giocatore

Campo	Descrizione
`number`	Il numero di maglia del giocatore (intero)
`nationalities`	Codici paese a 3 lettere per le nazionalità del giocatore (array di stringhe)
`teams`	Gli ID di tutte le squadre a cui il giocatore è affiliato (array — correnti e passate)
`current_teams`	Gli ID delle affiliazioni di squadra attuali attive del giocatore (array)
`past_teams`	Gli ID delle affiliazioni di squadra storiche del giocatore (array)
`metrics`	Misure delle prestazioni del giocatore (valori statici come altezza, peso)
`statistics`	Dati sulle prestazioni basati su lega e stagione (valori calcolati)

La maggior parte dei campi supporta più contesti (view, edit, embed), controllando la visibilità e le autorizzazioni di modifica in diversi scenari di accesso API.

Limitazione nota

I giocatori creati tramite la REST API potrebbero non apparire automaticamente nelle liste giocatori. Questa è una lacuna nota documentata nel forum di supporto. Dopo aver creato un giocatore tramite API, verifica che il giocatore sia assegnato al team corretto nell'admin di WordPress, e che la lista giocatori sia configurata per includere i giocatori di quel team.

Esempi di richieste

Elenca tutti i giocatori

GET /wp-json/sportspress/v2/players

Recupera un singolo giocatore

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

Crea un giocatore

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]
}

Aggiorna le metriche del giocatore

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

Nota: l'aggiornamento delle metriche del giocatore tramite REST API richiede SportsPress Pro 2.7.3 o versioni successive.

Filtra i giocatori per lega e stagione

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

Il filtraggio dell'endpoint della lista giocatori è stato aggiunto in SportsPress Pro 2.5.5.