Introduzione all'API REST
SportsPress 2.0 ha introdotto endpoint per la WP REST API, consentendo l'accesso programmatico per gestire i dati del sito. Il plugin richiede il plugin WP REST API (versione 2) per la funzionalità di base. WordPress 4.7 e versioni successive includono la REST API nativamente — nessun plugin aggiuntivo è richiesto sulle installazioni WordPress moderne.
Le richieste GET (lettura dei dati) non richiedono autenticazione. Le richieste POST, PUT e DELETE (creazione, aggiornamento o eliminazione dei dati) richiedono autenticazione.
URL base
Tutti gli endpoint della REST API di SportsPress sono disponibili sotto:
/wp-json/sportspress/v2/
Sostituisci example.com con il dominio del tuo sito:
https://example.com/wp-json/sportspress/v2/events
Endpoint disponibili
Risorsa | Endpoint |
Events |
|
Teams |
|
Players |
|
Staff |
|
Calendars |
|
League Tables |
|
Player Lists |
|
Ogni endpoint supporta le convenzioni standard della REST API di WordPress: elenca tutte le risorse con GET, recupera una singola risorsa con GET /{id}, crea con POST, aggiorna con PUT o PATCH, ed elimina con DELETE.
Metodi HTTP
Metodo | Azione |
| Recupera una o più risorse |
| Crea una nuova risorsa |
| Aggiorna una risorsa esistente |
| Elimina una risorsa |
Autenticazione
L'autenticazione è richiesta per tutte le operazioni di scrittura. Vedi l'articolo sull'Autenticazione per le istruzioni di configurazione usando Application Passwords e Postman.
Limitazioni note
I giocatori creati tramite la REST API potrebbero non apparire automaticamente nelle liste giocatori. Dopo aver creato un giocatore tramite API, assegna manualmente il giocatore al team pertinente nell'admin, oppure assicurati che la lista giocatori sia configurata per includere quel team.
Gli eventi pianificati (futuri) richiedono il valore di stato
futurequando vengono creati tramite API.Il parametro di query
_fieldsè supportato per filtrare i campi della risposta (disponibile in SportsPress Pro 2.7.16 e versioni successive dopo una correzione per un errore API con_fields).