Client API
SDK TypeScript ufficiale per Paragraph CMS. Collega le app con chiavi API per recuperare, elencare, creare e aggiornare contenuti tra pagine, raccolte e impostazioni locali.
Grzegorz
Il Client API è l'SDK TypeScript ufficiale per Paragraph CMS. Offre alle app esterne un modo pulito per lavorare con i contenuti archiviati nel CMS, che si tratti del frontend di un sito web, di un'integrazione lato server o di un'automazione interna.
È progettato per funzionare con le chiavi API ed è il ponte principale tra il lavoro editoriale all'interno di Paragraph CMS e le applicazioni che distribuiscono quei contenuti agli utenti finali.
A cosa lo usano i team
Il Client API è particolarmente utile quando un frontend o un servizio deve:
recuperare pagine per slug, raccolta o lingua,
elencare contenuti per una sezione come un blog o un'area documentazione,
leggere raccolte, etichette, stati, modelli di dati, lingue o media,
oppure creare e aggiornare contenuti in modo programmatico.
Questo lo rende una scelta naturale per i progetti costruiti con Next.js, Astro, React Router, Nuxt e SvelteKit.
Collegalo con una chiave API
La configurazione abituale è semplice: crea una chiave in Paragraph CMS, aggiungila alla tua applicazione e lascia che il client gestisca le richieste all'API pubblica.
Questo mantiene separati la superficie editoriale e il livello di distribuzione. I team possono gestire i contenuti in Pagine, Raccolte e Modelli di dati, quindi usare il client nel codice della loro app per leggere o aggiornare quei contenuti dove servono.
Vicino al flusso di lavoro editoriale
Paragraph CMS mostra anche esempi di codice all'interno del prodotto, rendendo più facile passare dalla configurazione dei contenuti all'implementazione. Raccolte, pagine, etichette e stati possono alimentare direttamente il lavoro sul frontend o le automazioni supportate dal client.
Questo è particolarmente utile quando lo stesso team possiede sia la struttura del CMS sia il sito o l'app che la utilizza.
Funziona bene con altri strumenti di distribuzione
Il Client API è anche il livello di base per il SEO Client, che genera file SEO a livello di sito come sitemap e feed dalla stessa fonte di contenuti.
