ApiCMS: l'API REST per automatizzare CartaCMS
Ogni sito CartaCMS nasce con una caratteristica che spesso resta nascosta finché non serve davvero: una API REST completa, pronta a gestire contenuti da fuori il browser. Il suo nome è ApiCMS.
Cosa permette di fare
Con un semplice header X-API-Key e una richiesta HTTP verso /admin/api.php puoi creare, leggere, aggiornare ed eliminare articoli, prodotti shop, pagine statiche, categorie, menu, footer e persino il CSS del tema attivo. Nessun pannello da aprire, nessun click da fare a mano: tutto scriptabile, tutto automatizzabile.
Tutte le azioni disponibili
Ecco l'elenco completo delle chiamate REST supportate da ApiCMS:
| Azione | Metodo | Cosa fa |
|---|---|---|
list_languages | GET | Elenco lingue attive sul sito |
list_categories | GET | Elenco categorie blog |
list_shop_categories | GET | Elenco categorie shop |
list_articles | GET | Elenco articoli del blog |
list_products | GET | Elenco prodotti dello shop |
list_pages | GET | Elenco pagine statiche |
get_article | GET | Legge un articolo esistente |
get_product | GET | Legge un prodotto esistente |
get_page | GET | Legge una pagina esistente |
create_article / update_article | POST | Crea o aggiorna un articolo del blog |
create_product / update_product | POST | Crea o aggiorna un prodotto dello shop |
create_page / update_page | POST | Crea o aggiorna una pagina statica |
delete_article / delete_product / delete_page | POST | Elimina un contenuto esistente |
create_category / update_category / delete_category | POST | Gestisce le categorie del blog |
create_shop_category / update_shop_category / delete_shop_category | POST | Gestisce le categorie dello shop |
get_menu / update_menu | GET/POST | Legge o aggiorna il menu di navigazione (per lingua) |
get_footer / update_footer | GET/POST | Legge o aggiorna il footer (per lingua) |
get_theme_css / update_theme_css | GET/POST | Legge o aggiorna il CSS del tema attivo |
Un esempio concreto
Creare un nuovo prodotto nello shop, con titolo, prezzo, descrizione e immagine, richiede una sola chiamata POST a create_product. La risposta torna già con l'URL pubblico della pagina appena creata, pronta da controllare. Lo stesso vale per un articolo, una pagina, o persino un aggiornamento del CSS del tema: leggi lo stato attuale con la get_* corrispondente, modifichi solo i campi che ti servono, e reinvii tutto con la update_*.
Per chi cambia contenuti spesso
Blog che pubblicano ogni giorno, shop con cataloghi stagionali, siti multilingua da tenere sincronizzati: ApiCMS trasforma un lavoro ripetitivo in un processo automatizzabile, mantenendo la stessa filosofia di CartaCMS — zero database, zero dipendenze, massima semplicità.