Événements

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

Définitions des champs

Champs de date et d'heure

Champ	Description
`date`	Date de publication dans le fuseau horaire du site (format ISO 8601)
`date_gmt`	Date de publication en GMT (format 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)

Champs d'identification

Champ	Description
`id`	Identifiant unique de l'objet (entier, lecture seule)
`guid`	Identifiant globalement unique (lecture seule)
`slug`	Identifiant alphanumérique unique à son type
`link`	URL de l'objet (lecture seule)

Champs de contenu

Champ	Description
`title`	Le titre de l'objet événement
`content`	Le contenu de l'objet événement
`excerpt`	L'extrait de l'objet événement
`featured_media`	ID du média mis en avant pour l'objet

Champs de statut et d'accès

Champ	Description
`status`	Statut nommé de l'objet ; l'un des suivants : `publish`, `future`, `draft`, `pending` ou `private`
`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`

Champs d'auteur et d'ordre

Champ	Description
`author`	L'ID de l'auteur de l'objet
`menu_order`	L'ordre de l'objet par rapport aux autres objets de son type

Champs de taxonomie et de relation

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)
`venues`	Les termes assignés à l'objet dans la taxonomie lieu (tableau d'IDs de termes)
`teams`	Les IDs des équipes participant à l'événement (tableau)
`players`	Les IDs des joueurs participant à l'événement (tableau)
`staff`	Les IDs des membres du staff participant à l'événement (tableau)

Champs spécifiques aux événements

Champ	Description
`main_results`	Les résultats principaux de l'événement (tableau, une valeur par équipe)
`outcome`	Le résultat de l'événement par équipe (tableau)
`winner`	L'ID de l'équipe gagnante
`minutes`	La durée totale de l'événement en minutes (entier)
`results`	Le tableau complet des résultats de l'événement, par équipe (tableau)
`performance`	Le tableau complet de performance (feuille de match) de l'événement, par équipe (tableau)

Tous les champs spécifient la disponibilité du contexte (view, edit, embed). Les champs marqués comme lecture seule ne peuvent pas être définis dans les requêtes POST ou PUT.

Exemples de requêtes

Lister tous les événements

GET /wp-json/sportspress/v2/events

Récupérer un événement unique

GET /wp-json/sportspress/v2/events/123

Créer un événement

POST /wp-json/sportspress/v2/events
Content-Type: application/json{
  "title": "Team A vs Team B",
  "status": "publish",
  "date": "2026-05-01T15:00:00",
  "teams": [10, 11],
  "leagues": [5],
  "seasons": [3]
}

Mettre à jour les résultats d'un événement

PUT /wp-json/sportspress/v2/events/123
Content-Type: application/json{
  "results": {
    "10": { "goals": 2 },
    "11": { "goals": 1 }
  },
  "performance": {
    "10": {
      "42": { "goals": 1, "assists": 0 }
    }
  }
}

Remarque : La mise à jour des résultats et de la performance des joueurs via l'API REST nécessite SportsPress Pro 2.7.8 ou version ultérieure (les versions antérieures avaient un bug où les résultats et les feuilles de match ne se mettaient pas à jour via l'API).