Come Pubblicare un Articolo in WordPress Tramite API e Impostare la Categoria: Guida Completa

Introduzione al WordPress REST API

WordPress REST API è un’interfaccia che consente di interagire con un sito WordPress attraverso richieste HTTP, permettendo di creare, aggiornare, eliminare e leggere contenuti in modo programmatico. Questo rende possibile automatizzare la pubblicazione di articoli, gestire categorie e molto altro, senza dover accedere manualmente al backend di WordPress.

Come Pubblicare un Articolo Tramite API

Per pubblicare un articolo tramite la REST API di WordPress, è necessario inviare una richiesta POST all’endpoint dedicato ai post, fornendo i dati necessari come titolo, contenuto, stato di pubblicazione e autore.

Un esempio minimo di dati per creare un post è:

{
  "title": "Titolo del post",
  "content": "Contenuto del post",
  "status": "publish",
  "author": 1
}

Dove author è l’ID numerico di un utente con i permessi adeguati.

La richiesta deve includere un’intestazione di autenticazione Basic, che codifica il nome utente e la password dell’applicazione (application password), per garantire i permessi necessari.

Esempio di header di autenticazione in Python:

WORDPRESS_CREDENTIALS = USER_NAME + ":" + APPLICATION_PASSWORD
WORDPRESS_TOKEN = base64.b64encode(WORDPRESS_CREDENTIALS.encode())
WORDPRESS_HEADER = {'Authorization': 'Basic ' + WORDPRESS_TOKEN.decode('utf-8')}

L’endpoint API tipico per i post è:

https://tuosito.it/wp-json/wp/v2/posts

Inviare una POST a questo URL con i dati e l’header permette di creare un nuovo articolo.

Impostare la Categoria durante la Creazione dell’Articolo

Per associare un articolo a una categoria specifica, è necessario includere nel payload della richiesta un array di ID di categorie. Ad esempio:

{
  "title": "Titolo del post",
  "content": "Contenuto del post",
  "status": "publish",
  "categories": [5, 9]
}

In questo esempio, l’articolo sarà assegnato alle categorie con ID 5 e 9. Gli ID delle categorie possono essere recuperati dal backend di WordPress o tramite una chiamata GET all’endpoint /wp-json/wp/v2/categories.

Passaggi Pratici per Pubblicare un Articolo con Categoria via API

• 1. Ottenere le credenziali: creare un Application Password per un utente con permessi di amministratore.
• 2. Recuperare gli ID categorie: effettuare una chiamata GET a /wp-json/wp/v2/categories per conoscere gli ID disponibili.
• 3. Preparare i dati del post: includere titolo, contenuto, stato, autore e categorie.
• 4. Inviare la richiesta POST: effettuare una chiamata POST all’endpoint /wp-json/wp/v2/posts con i dati e l’header di autenticazione.
• 5. Verificare la risposta: la risposta JSON conterrà i dati del post creato se la richiesta è andata a buon fine.

Considerazioni sulla Sicurezza e Best Practice

È fondamentale utilizzare una connessione HTTPS per proteggere le credenziali di accesso. Inoltre, utilizzare application password specifiche per l’integrazione API evita di esporre la password principale dell’utente. Gestire con attenzione i permessi degli utenti e validare le risposte API aiuta a mantenere il sito sicuro e stabile.

Conclusioni

La REST API di WordPress offre un potente strumento per pubblicare articoli programmaticamente e assegnare categorie in modo semplice e automatizzato. Seguendo i passaggi descritti, è possibile integrare WordPress con sistemi esterni, applicazioni o script personalizzati per la gestione dinamica dei contenuti.