Joueurs

Point de terminaison : /wp-json/sportspress/v2/players

Définitions des champs

Champs d'identification et de publication

Champ	Description
`id`	Identifiant unique de l'objet (entier, lecture seule)
`guid`	Identifiant globalement unique (lecture seule)
`slug`	Identifiant alphanumérique adapté aux URL, unique à son type
`link`	URL de l'objet (lecture seule)
`date`	Horodatage de publication dans le fuseau horaire du site (ISO 8601)
`date_gmt`	Date de publication en GMT (ISO 8601)
`modified`	Date de dernière modification dans le fuseau horaire du site (lecture seule)
`modified_gmt`	Date de dernière modification en GMT (lecture seule)
`status`	État de publication ; l'un des suivants : `publish`, `future`, `draft`, `pending` ou `private`

Champs de contenu et métadonnées

Champ	Description
`title`	Le nom du joueur
`content`	La biographie ou description du joueur
`excerpt`	Un bref résumé du joueur
`featured_media`	L'ID de la photo du joueur (image mise en avant)
`author`	L'ID du compte utilisateur du créateur

Champs de statut et d'accès

Champ	Description
`password`	Un mot de passe pour protéger l'accès au contenu et à l'extrait
`comment_status`	Si les commentaires sont ouverts ou non ; `open` ou `closed`
`ping_status`	Si l'objet peut être pingé ou non ; `open` ou `closed`
`menu_order`	L'ordre de l'objet par rapport aux autres objets de son type

Champs de taxonomie

Champ	Description
`leagues`	Les termes assignés à l'objet dans la taxonomie ligue (tableau d'IDs de termes)
`seasons`	Les termes assignés à l'objet dans la taxonomie saison (tableau d'IDs de termes)
`positions`	Les termes assignés à l'objet dans la taxonomie position (tableau d'IDs de termes)

Champs spécifiques aux joueurs

Champ	Description
`number`	Le numéro de maillot du joueur (entier)
`nationalities`	Codes de pays à 3 lettres pour les nationalités du joueur (tableau de chaînes)
`teams`	Les IDs de toutes les équipes auxquelles le joueur est affilié (tableau — actuelles et passées)
`current_teams`	Les IDs des affiliations d'équipes actuelles actives du joueur (tableau)
`past_teams`	Les IDs des affiliations d'équipes historiques du joueur (tableau)
`metrics`	Mesures de performance du joueur (valeurs statiques comme la taille, le poids)
`statistics`	Données de performance basées sur la ligue et la saison (valeurs calculées)

La plupart des champs prennent en charge plusieurs contextes (view, edit, embed), contrôlant la visibilité et les permissions de modification dans différents scénarios d'accès à l'API.

Limitation connue

Les joueurs créés via l'API REST peuvent ne pas apparaître automatiquement dans les listes de joueurs. C'est un écart documenté sur le forum d'assistance. Après avoir créé un joueur via l'API, vérifiez que le joueur est assigné à la bonne équipe dans l'administration WordPress et que la liste de joueurs est configurée pour inclure les joueurs de cette équipe.

Exemples de requêtes

Lister tous les joueurs

GET /wp-json/sportspress/v2/players

Récupérer un joueur unique

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

Créer un joueur

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

Mettre à jour les métriques d'un joueur

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

Remarque : La mise à jour des métriques des joueurs via l'API REST nécessite SportsPress Pro 2.7.3 ou version ultérieure.

Filtrer les joueurs par ligue et saison

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

Le filtrage du point de terminaison de liste de joueurs a été ajouté dans SportsPress Pro 2.5.5.