Så här uppdaterar du innehåll via AEM Assets API:er update-your-content

I den här delen av AEM Headless Developer Journeyfår du lära dig hur du använder REST API för att komma åt och uppdatera innehållet i dina innehållsfragment.

Story hittills story-so-far

I det tidigare dokumentet av den AEM resan Hur du får åtkomst till ditt innehåll via AEM-API:er fick du lära dig hur du får åtkomst till ditt headless-innehåll i AEM via AEM GraphQL API, och du bör nu:

Den här artikeln bygger på dessa grundläggande funktioner så att du förstår hur du uppdaterar det befintliga headless-innehållet i AEM via REST API.

Syfte objective

Varför behöver du Assets HTTP API för innehållsfragment why-http-api

I det föregående steget i Headless Journey lärde du dig att använda AEM GraphQL API för att hämta ditt innehåll med hjälp av frågor.

Varför behövs en annan API?

Assets HTTP API tillåter att du läser ditt innehåll, men det gör även att du kan skapa, uppdatera och ta bort -innehåll - åtgärder som inte är möjliga med GraphQL API.

Assets REST API är tillgängligt för alla färdiga installationer av en nyligen använd Adobe Experience Manager as a Cloud Service-version.

ASSETS HTTP API assets-http-api

Assets HTTP API omfattar:

Den aktuella implementeringen av Assets HTTP API baseras på arkitekturstilen REST och gör att du kan komma åt innehåll (som lagras i AEM) via CRUD-åtgärder (Skapa, Läs, Uppdatera, Ta bort).

Med de här åtgärderna kan du med API:t köra Adobe Experience Manager as a Cloud Service som ett headless CMS (Content Management System) genom att tillhandahålla innehållstjänster till ett JavaScript front end-program. Eller något annat program som kan köra HTTP-begäranden och hantera JSON-svar. Exempelvis kräver Single Page-program (SPA), ramverksbaserade eller anpassade, innehåll som tillhandahålls via ett API, ofta i JSON-format.

Assets HTTP API och innehållsfragment assets-http-api-content-fragments

Innehållsfragment används för rubrikfri leverans och ett innehållsfragment är en särskild typ av resurs. De används för att komma åt strukturerade data, t.ex. texter, siffror och datum.

Använda Assets REST API using-aem-assets-rest-api

Åtkomst access

Assets REST API använder slutpunkten /api/assets och kräver att resursens sökväg har åtkomst till den (utan inledande /content/dam).

Om du till exempel vill komma åt /content/dam/wknd/en/adventures/cycling-tuscany begär du /api/assets/wknd/en/adventures/cycling-tuscany.json

Åtgärd operation

HTTP-metoden avgör vilken åtgärd som ska utföras:

Det exakta formatet för begäranden som stöds definieras i API-referensdokumentationen.

Användningen kan variera beroende på om du använder en AEM författare eller publiceringsmiljö, tillsammans med ditt specifika användningsexempel.

Läsning/leverans read-delivery

Användning sker via:

GET /{cfParentPath}/{cfName}.json

Till exempel:

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

Svaret är serialiserat JSON med innehållet strukturerat som i innehållsfragmentet. Referenser levereras som referens-URL:er.

Det finns två typer av läsåtgärder:

Skapa create

Användning sker via:

POST /{cfParentPath}/{cfName}

Brödtexten måste innehålla en JSON-representation av det innehållsfragment som ska skapas, inklusive allt ursprungligt innehåll som ska anges för elementen i innehållsfragmentet. Det är obligatoriskt att ange egenskapen cq:model och den måste peka på en giltig innehållsfragmentmodell. Om du inte gör det kommer ett fel att uppstå. Du måste också lägga till rubriken Content-Type som är inställd på application/json.

Uppdatera update

Användning sker via

PUT /{cfParentPath}/{cfName}

Brödtexten måste innehålla en JSON-representation av vad som ska uppdateras för det angivna innehållsfragmentet.

Detta kan helt enkelt vara titeln eller beskrivningen av ett innehållsfragment, ett enskilt element eller alla elementvärden och/eller metadata.

Ta bort delete

Användning sker genom:

DELETE /{cfParentPath}/{cfName}

Mer information om hur du använder AEM Assets REST API finns i:

What's Next whats-next

Nu när du är klar med den här delen av AEM Headless Developer Journey ska du:

Du bör fortsätta den AEM resan utan att behöva lämna synpunkter nästa gång du granskar dokumentet Placera allt tillsammans - Din app och ditt innehåll i AEM utan rubrik där du lär dig grunderna och verktygen i AEM arkitektur som du behöver för att sätta ihop ditt program.

Ytterligare resurser additional-resources