L'addon REST API (introdotto con AIOSEO 4.1.9) è disponibile per tutti gli utenti dei piani Plus, Pro ed Elite e ti consente di recuperare e aggiornare facilmente i dati AIOSEO tramite l'API REST.
Ciò può essere particolarmente utile quando, ad esempio, hai:
- Un sito WordPress headless in cui devi visualizzare manualmente i tuoi dati SEO sul frontend;
- Un sistema di terze parti per gestire i tuoi post (ad es. ERP per e-commerce con integrazione WooCommerce) e desideri poter gestire i tuoi dati SEO tramite quel sistema.
Di seguito spiegheremo quali dati sono disponibili tramite l'API REST e come puoi aggiornarli.
NOTA:
L'addon REST API è disponibile per i clienti con un piano Plus o superiore per All in One SEO Pro.
Aggiorna oggi stesso ad All in One SEO Pro per ottenere l'addon REST API e molte altre funzionalità!
Recupero dei dati
Invece di registrare endpoint personalizzati, l'addon REST API si integra con gli endpoint predefiniti del Core di WordPress. Attualmente, sono supportate tutte le route GET per post e termini.
Questi includono:
- /wp/v2/posts
- /wp/v2/pages
- /wp/v2/media
- /wp/v2/categories
- /wp/v2/tags
E anche tutte le route per i tipi di post personalizzati e le tassonomie personalizzate sul tuo sito web che hanno il supporto per la REST API abilitato.
I seguenti campi saranno inclusi nella risposta di queste route:
aioseo_head
Questo campo include i dati SEO grezzi che verrebbero normalmente generati da All in One SEO nel codice sorgente del tuo post/termine come stringa di testo.
Se hai un sito web WordPress headless, puoi visualizzare questi dati direttamente nel codice sorgente sul frontend della tua installazione.
aioseo_head_json
Questo campo include gli stessi valori dei dati aioseo_head (vedi sopra), ma in formato JSON.
Ciò ti consente di filtrare facilmente i dati prima di visualizzarli nel codice sorgente o di utilizzarli per altri scopi.
Tieni presente che questi dati non includono il codice HTML per i meta tag per cui vengono utilizzati questi valori, quindi dovrai costruirli tu stesso.
aioseo_meta_data
Questo campo include i dati archiviati nelle tabelle personalizzate di post e termini di AIOSEO in formato JSON.
Questi dati dovrebbero essere utilizzati principalmente quando si desidera manipolare i dati esistenti e quindi aggiornarli sul proprio sito web.
Aggiornamento dei dati
Per aggiornare i dati tramite l'API REST, devi autenticarti. Se non sei sicuro di come farlo, leggi la documentazione dell'API REST di WordPress.
L'utente con cui ti sei autenticato deve inoltre disporre di una qualsiasi delle seguenti autorizzazioni per poter aggiornare i dati AIOSEO tramite l'API REST:
- aioseo_page_general_settings
- aioseo_page_social_settings
- aioseo_page_schema_settings
- aioseo_page_advanced_settings
Una volta soddisfatti questi requisiti, è possibile aggiornare i dati tramite una richiesta POST/PUT aggiungendo la proprietà aioseo_meta_data nel corpo della richiesta.
All'interno di questa proprietà, è possibile specificare una qualsiasi delle chiavi incluse nel campo aioseo_meta_data (vedi sopra), insieme al nuovo valore.
Di seguito un esempio di come si presenta:
{
"aioseo_meta_data": {
"title":"NEW TITLE",
"description":"NEW DESCRIPTION"
}
}
Se hai domande particolari sull'API REST, non esitare a contattare il nostro team di supporto. Saremo lieti di aiutarti.