Glossario · ThinkClouds

REST API di WordPress

Interfaccia con cui programmi esterni e script nel browser leggono e modificano i contenuti di WordPress scambiando dati JSON su HTTP.

La REST API di WordPress è l’interfaccia con cui programmi e script leggono e modificano i dati di un sito scambiando JSON su HTTP, invece di passare dalle pagine del pannello. È entrata nel core con la versione 4.7, nel dicembre 2016, e risponde sotto l’indirizzo /wp-json/. L’editor a blocchi, buona parte di Elementor e moltissimi plugin la usano per comunicare con il server.

Rotte, endpoint, namespace

Una rotta è un percorso, come /wp/v2/posts; un endpoint è la combinazione di una rotta con un metodo HTTP: GET per leggere, POST per creare o modificare, DELETE per eliminare. Le rotte sono raggruppate in namespace: wp/v2 per il core, thinkseo/v1 o thinkglossary/v1 per i plugin. L’indice /wp-json/ elenca tutte le rotte registrate, e una richiesta OPTIONS su una rotta restituisce lo schema dei dati che accetta.

Autenticazione

Molte rotte sono pubbliche in lettura: chiunque può leggere gli articoli pubblicati, come può farlo dal sito. Per scrivere servono permessi, e WordPress offre due strade. Gli script che girano nel browser di un utente collegato usano il cookie di sessione più un nonce nell’intestazione X-WP-Nonce. I programmi esterni usano le Application Password, introdotte nella versione 5.6. In entrambi i casi la rotta verifica le capability dell’utente prima di agire.

Sicurezza

La REST API espone di serie alcune informazioni che un attaccante può usare, come l’elenco degli autori, e ogni plugin che registra rotte proprie ne amplia la superficie. Una rotta scritta male, che dimentica il controllo dei permessi, è una delle vulnerabilità più frequenti nei plugin. Le misure di hardening chiudono agli anonimi ciò che non deve essere pubblico, ma bloccare tutta la REST API ai visitatori rompe funzioni che ne hanno bisogno.

Nei plugin ThinkClouds

Quasi tutti i plugin ThinkClouds hanno rotte proprie, usate dai loro widget e dagli strumenti di manutenzione: ThinkSEO per la SEO di contenuti e termini, ThinkGlossary per import ed export, ThinkRedirect per le regole. ThinkBridge apre un insieme di rotte pensate per lavorare da remoto su template, documenti Elementor, menu e media, con i propri controlli aggiuntivi. ThinkShield nega agli anonimi la rotta degli utenti e permette di regolare l’accesso namespace per namespace.

Fonti

Serve aiuto?

Installiamo, configuriamo e colleghiamo il plugin al tuo sito, con i template Elementor già pronti.