Come aggiornare il contenuto utilizzando le API di AEM Assets. update-your-content

In questa parte del Percorso per sviluppatori headless di AEM, scopri come utilizzare l’API REST per accedere e aggiornare il contenuto dei frammenti di contenuto.

Percorso affrontato finora story-so-far

Nel documento precedente del percorso headless di AEM, Come accedere ai contenuti utilizzando API di distribuzione di AEM hai imparato ad accedere ai contenuti headless in AEM utilizzando l’API GraphQL AEM e ora dovresti:

Questo articolo si basa su questi elementi fondamentali per comprendere come aggiornare il contenuto headless esistente in AEM utilizzando l’API REST.

Obiettivo objective

Perché è necessaria l’API HTTP delle risorse per i frammenti di contenuto why-http-api

Nella fase precedente del Percorso Headless, hai imparato a usare l’API GraphQL di AEM per recuperare il contenuto utilizzando le query.

Allora perché è necessaria un'altra API?

L'API HTTP di Assets consente di leggere il contenuto, ma consente anche di creare, aggiornare e eliminare contenuto - azioni che non sono possibili con l'API di GraphQL.

L’API REST di Assets è disponibile su ogni installazione predefinita di una versione recente di Adobe Experience Manager.

API HTTP di Assets assets-http-api

L’API HTTP di Assets include:

L’implementazione corrente dell’API HTTP di Assets si basa sullo stile architettonico REST e consente di accedere ai contenuti (memorizzati in AEM) utilizzando operazioni CRUD (Create (Crea), Read (Leggi), Update (Aggiorna) e Delete (Elimina)).

Con queste operazioni l’API consente di utilizzare Adobe Experience Manager come CMS (Content Management System) headless fornendo Content Services a un’applicazione front-end JavaScript. O qualsiasi altra applicazione in grado di eseguire richieste HTTP e gestire risposte JSON. Ad esempio, le applicazioni a pagina singola (SPA), basate su framework o personalizzate, richiedono il contenuto fornito tramite un’API, spesso in formato JSON.

API HTTP di Assets e frammenti di contenuto assets-http-api-content-fragments

I frammenti di contenuto vengono utilizzati per la distribuzione headless e un frammento di contenuto è un tipo speciale di risorsa. Vengono utilizzati per accedere a dati strutturati, tra cui testi, numeri, date.

Utilizzo dell’API REST di Assets using-aem-assets-rest-api

Accesso access

L’API REST di Assets utilizza l’/api/assets endpoint e richiede il percorso della risorsa per accedervi (senza l’iniziale /content/dam).

Ad esempio, per accedere a /content/dam/wknd/en/adventures/cycling-tuscany, richiedi /api/assets/wknd/en/adventures/cycling-tuscany.json

Operazione operation

Il metodo HTTP determina l’operazione da eseguire:

Il formato esatto delle richieste supportate è definito nella documentazione di riferimento API.

L’utilizzo può variare a seconda che utilizzi un ambiente di authoring o pubblicazione di AEM, insieme al tuo caso d’uso specifico.

Lettura/consegna read-delivery

L’utilizzo avviene tramite:

GET /{cfParentPath}/{cfName}.json

Esempio:

http://<host>/api/assets/wknd/en/adventures/cycling-tuscany.json

La risposta viene serializzata JSON con il contenuto strutturato come nel frammento di contenuto. I riferimenti vengono consegnati come URL di riferimento.

Sono possibili due tipi di operazioni di lettura:

Creare create

L’utilizzo avviene tramite:

POST /{cfParentPath}/{cfName}

Il corpo deve contenere una rappresentazione JSON del frammento di contenuto da creare, incluso qualsiasi contenuto iniziale da impostare sugli elementi del frammento di contenuto. È obbligatorio impostare la proprietà cq:model e deve puntare a un modello di frammento di contenuto valido. In caso contrario si verifica un errore. È inoltre necessario aggiungere un’intestazione Content-Type che è impostata su application/json.

Aggiornare update

L’utilizzo avviene tramite:

PUT /{cfParentPath}/{cfName}

Il corpo deve contenere una rappresentazione JSON di ciò che deve essere aggiornato per il frammento di contenuto specificato.

Può trattarsi semplicemente del titolo o della descrizione di un frammento di contenuto, di un singolo elemento o di tutti i valori e/o metadati degli elementi.

Eliminare delete

L’utilizzo avviene tramite:

DELETE /{cfParentPath}/{cfName}

Per ulteriori dettagli sull’utilizzo dell’API REST di AEM Assets, puoi fare riferimento a:

Passaggio successivo whats-next

Ora che hai completato questa parte del percorso per sviluppatori headless di AEM, dovresti:

Continua il tuo percorso di headless AEM esaminando il documento How to Go Live with Your Headless Application in cui realizzi il progetto AEM Headless.

Risorse aggiuntive additional-resources