REST API Einführung
SportsPress 2.0 führte Endpunkte für die WP REST API ein und ermöglicht damit programmgesteuerten Zugriff auf Standortdaten. WordPress 4.7 und höher enthält die REST API nativ — ein zusätzliches Plugin ist bei modernen WordPress-Installationen nicht erforderlich.
GET-Anfragen (Datenlesen) erfordern keine Authentifizierung. POST-, PUT- und DELETE-Anfragen (Erstellen, Aktualisieren oder Löschen von Daten) erfordern eine Authentifizierung.
Basis-URL
Alle SportsPress REST API-Endpunkte sind unter folgender URL verfügbar:
/wp-json/sportspress/v2/
Ersetzen Sie example.com durch die Domain Ihrer Website:
https://example.com/wp-json/sportspress/v2/events
Verfügbare Endpunkte
Ressource | Endpunkt |
Ereignisse |
|
Mannschaften |
|
Spieler |
|
Personal |
|
Kalender |
|
Ligatabellen |
|
Spielerlisten |
|
Jeder Endpunkt unterstützt die Standard-Konventionen der WordPress REST API: Alle Ressourcen per GET auflisten, eine einzelne Ressource per GET /{id} abrufen, mit POST erstellen, mit PUT oder PATCH aktualisieren und mit DELETE löschen.
HTTP-Methoden
Methode | Aktion |
| Eine oder mehrere Ressourcen abrufen |
| Eine neue Ressource erstellen |
| Eine vorhandene Ressource aktualisieren |
| Eine Ressource löschen |
Authentifizierung
Für alle Schreibvorgänge ist eine Authentifizierung erforderlich. Einrichtungsanweisungen mit Anwendungspasswörtern und Postman finden Sie im Artikel zur Authentifizierung.
Bekannte Einschränkungen
Über die REST API erstellte Spieler erscheinen möglicherweise nicht automatisch in Spielerlisten. Weisen Sie den Spieler nach der API-Erstellung manuell dem entsprechenden Team in der Verwaltung zu, oder stellen Sie sicher, dass die Spielerliste so konfiguriert ist, dass dieses Team eingeschlossen ist.
Geplante (zukünftige) Ereignisse erfordern bei der API-Erstellung den Statuswert
future.Der Abfrageparameter
_fieldswird zum Filtern von Antwortfeldern unterstützt (verfügbar in SportsPress Pro 2.7.16 und höher).