Autenticazione
Questa guida illustra come autenticare le richieste alla REST API di SportsPress usando Application Passwords e Postman.
Le richieste GET (lettura dei dati) non richiedono autenticazione. L'autenticazione è richiesta per le operazioni POST, PUT, PATCH e DELETE.
Prerequisiti:
Un'installazione WordPress con SportsPress attivo
Account utente Amministratore o Editor
Passaggio 1 — Scaricare e installare Postman
Visita https://www.postman.com/downloads/ e scarica l'applicazione desktop. La creazione di un account è opzionale. Dopo l'installazione, apri l'app e crea un account oppure seleziona "Skip and go to the app." Crea una nuova richiesta facendo clic sulla scheda [+].
Passaggio 2 — Generare una Application Password
Le Application Passwords sono integrate in WordPress 5.6 e versioni successive. Per le versioni precedenti, installa il plugin Application Passwords da https://wordpress.org/plugins/application-passwords/.
Vai a Utenti nel tuo admin WordPress.
Fai clic sul tuo nome utente per aprire il profilo utente.
Scorri fino alla sezione Application Passwords.
Inserisci un nome per la password (es. "Postman" o "API Client").
Fai clic su Add New Application Password.
Una finestra modale mostra la password generata — copiala immediatamente e conservala in modo sicuro. Non verrà mostrata di nuovo.
Passaggio 3 — Configurare Basic Auth in Postman
Apri la tua richiesta in Postman.
Fai clic sulla scheda Authorization.
Imposta il Type su Basic Auth.
Inserisci il tuo Username WordPress nel campo Username.
Incolla la Application Password generata nel Passaggio 2 nel campo Password.
Passaggio 4 — Impostare l'header Content-Type
Per le richieste POST, PUT e PATCH che inviano un corpo JSON, aggiungi il seguente header:
Chiave | Valore |
|
|
Naviga alla scheda Headers in Postman e aggiungi questa coppia chiave-valore.
Passaggio 5 — Inviare una richiesta di test
Testa l'autenticazione con una richiesta GET che non richiede auth per confermare la connettività:
GET https://example.com/wp-json/sportspress/v2/teams
Poi testa un'operazione di scrittura. Ad esempio, aggiorna una squadra:
PUT https://example.com/wp-json/sportspress/v2/teams/123
Con un corpo JSON:
{
"title": "Updated Team Name"
}Una risposta 200 OK con l'oggetto aggiornato conferma che l'autenticazione funziona.
Autenticazione nel codice
Per le integrazioni lato server, passa le credenziali tramite l'header Authorization usando username:application_password codificato in Base64:
$response = wp_remote_post(
'https://example.com/wp-json/sportspress/v2/events',
array(
'headers' => array(
'Authorization' => 'Basic ' . base64_encode( 'username:application-password' ),
'Content-Type' => 'application/json',
),
'body' => json_encode( array(
'title' => 'New Event',
'status' => 'publish',
) ),
)
);Per i client JavaScript in esecuzione nel browser, usa l'autenticazione basata su cookie con un nonce — consulta la guida all'autenticazione della WP REST API v2 per i dettagli.