Spieler

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

Felddefinitionen

Identifikations- und Veröffentlichungsfelder

Feld	Beschreibung
`id`	Eindeutige Kennung des Objekts (Integer, schreibgeschützt)
`guid`	Global eindeutige Kennung (schreibgeschützt)
`slug`	URL-freundliche alphanumerische Kennung, eindeutig für den Typ
`link`	URL zum Objekt (schreibgeschützt)
`date`	Veröffentlichungszeitstempel in der Zeitzone der Website (ISO 8601)
`date_gmt`	Veröffentlichungsdatum als GMT (ISO 8601)
`modified`	Datum der letzten Änderung in der Zeitzone der Website (schreibgeschützt)
`modified_gmt`	Datum der letzten Änderung als GMT (schreibgeschützt)
`status`	Veröffentlichungsstatus; einer von `publish`, `future`, `draft`, `pending` oder `private`

Inhalts- und Metadatenfelder

Feld	Beschreibung
`title`	Der Name des Spielers
`content`	Die Biografie oder Beschreibung des Spielers
`excerpt`	Eine kurze Zusammenfassung des Spielers
`featured_media`	Die ID des Fotos des Spielers (Beitragsbild)
`author`	Die ID des Ersteller-Benutzerkontos

Status- und Zugriffsfelder

Feld	Beschreibung
`password`	Passwort zum Schutz des Zugriffs auf Inhalt und Zusammenfassung
`comment_status`	Ob Kommentare geöffnet sind; `open` oder `closed`
`ping_status`	Ob das Objekt angepingt werden kann; `open` oder `closed`
`menu_order`	Die Reihenfolge des Objekts in Relation zu anderen Objekten des gleichen Typs

Taxonomiefelder

Feld	Beschreibung
`leagues`	Dem Objekt in der Liga-Taxonomie zugewiesene Terme (Array von Term-IDs)
`seasons`	Dem Objekt in der Saison-Taxonomie zugewiesene Terme (Array von Term-IDs)
`positions`	Dem Objekt in der Positions-Taxonomie zugewiesene Terme (Array von Term-IDs)

Spielerspezifische Felder

Feld	Beschreibung
`number`	Die Trikotnummer des Spielers (Integer)
`nationalities`	3-Buchstaben-Ländercodes für die Nationalitäten des Spielers (Array von Strings)
`teams`	IDs aller Mannschaften, denen der Spieler angehört (Array — aktuell und vergangen)
`current_teams`	IDs der aktuell aktiven Mannschaftszugehörigkeiten des Spielers (Array)
`past_teams`	IDs der früheren Mannschaftszugehörigkeiten des Spielers (Array)
`metrics`	Leistungsmessungen des Spielers (statische Werte wie Größe, Gewicht)
`statistics`	Liga- und saisonbasierte Leistungsdaten (berechnete Werte)

Die meisten Felder unterstützen mehrere Kontexte (view, edit, embed) und steuern Sichtbarkeit und Änderungsberechtigungen in verschiedenen API-Zugriffsszenarien.

Bekannte Einschränkung

Über die REST API erstellte Spieler erscheinen möglicherweise nicht automatisch in Spielerlisten. Nach der API-Erstellung eines Spielers stellen Sie sicher, dass der Spieler in der WordPress-Verwaltung dem korrekten Team zugewiesen ist und die Spielerliste so konfiguriert ist, dass Spieler dieses Teams eingeschlossen werden.

Beispielanfragen

Alle Spieler auflisten

GET /wp-json/sportspress/v2/players

Einen einzelnen Spieler abrufen

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

Einen Spieler erstellen

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

Spieler-Metriken aktualisieren

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

Hinweis: Das Aktualisieren von Spieler-Metriken über die REST API erfordert SportsPress Pro 2.7.3 oder höher.

Spieler nach Liga und Saison filtern

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

Das Filtern des Spielerlisten-Endpunkts wurde in SportsPress Pro 2.5.5 hinzugefügt.

Verwandte Artikel