Un namespace REST è il prefisso che raggruppa le rotte registrate da un plugin o dal core nella REST API di WordPress. Nell’indirizzo /wp-json/thinkseo/v1/lengths il namespace è thinkseo/v1: la prima parte identifica chi ha registrato la rotta, la seconda la versione dell’interfaccia. Il core usa wp/v2; ogni plugin deve scegliere un namespace proprio, per non entrare in conflitto con gli altri.
Perché la versione
La versione nel namespace permette a un plugin di cambiare il formato dei dati senza rompere i programmi che usano la versione precedente: le rotte v1 continuano a funzionare mentre le nuove nascono in v2. È una regola di buona educazione verso chi integra il plugin, e diventa indispensabile quando le rotte sono usate da altri siti o da applicazioni esterne, come nel caso dei controlli che ThinkRepo fa sui siti tramite ThinkWatch.
Un’unità di controllo
Per chi difende un sito, il namespace è il modo naturale di ragionare sulla superficie della REST API: invece di valutare centinaia di rotte una per una, si valutano i plugin che le hanno registrate. Dal 2025 questa visione è diventata più importante con l’arrivo di plugin che espongono funzioni del sito a strumenti di intelligenza artificiale, come i server basati sul Model Context Protocol (MCP) e la Abilities API di WordPress: rotte che permettono a un agente di leggere e modificare contenuti, e che vanno aperte solo a chi deve usarle.
In ThinkShield
La scheda Hardening di ThinkShield ha una policy per namespace. Elenca i namespace registrati sul sito, evidenzia quelli sensibili (MCP, Abilities API, agenti noti, plugin con rotte di scrittura) e per ciascuno permette di lasciare il comportamento normale, di ammettere solo gli amministratori o di bloccare. I namespace dei plugin ThinkClouds, ThinkBridge compreso, richiedono una conferma separata, perché bloccarli può fermare widget e strumenti di manutenzione. Il pulsante Verifica fa richieste anonime al sito e mostra, per ogni namespace, se la risposta è 403 (protetto), 404 (rimosso) o 200 (accessibile). Una policy di blocco rapido per i namespace MCP è disponibile anche da sola.