Uw inhoud bijwerken via AEM Assets API's update-your-content

In dit deel van de Hoofdloze Reis van de Ontwikkelaar van AEM,leert hoe te om REST API te gebruiken om tot de inhoud van uw Fragments van de Inhoud toegang te hebben en bij te werken.

Het verhaal tot nu toe story-so-far

In het vorige document van de hoofdloze reis van AEM, hoe te om tot Uw Inhoud via de Levering APIs van AEM toegang te hebbenleerde u hoe te om tot uw inhoud zonder kop in AEM via AEM GraphQL API toegang te hebben en u zou nu moeten:

Dit artikel bouwt verder op deze basisbeginselen, zodat u begrijpt hoe u uw bestaande inhoud zonder kop in AEM kunt bijwerken via de REST API.

Doelstelling objective

Waarom hebt u de Assets HTTP API voor inhoudsfragmenten nodig? why-http-api

In de vorige fase van de Headless Journey hebt u geleerd hoe u de AEM GraphQL API kunt gebruiken om uw inhoud op te halen met behulp van query's.

Waarom is er dus nog een API nodig?

De HTTP API van Assets laat u ​ ​lezen uw inhoud, maar het laat u ook ​ ​creëren, Update en schrapt inhoud - acties die niet met GraphQL API mogelijk zijn.

De Assets REST-API is beschikbaar voor elke installatie van een recente Adobe Experience Manager-versie die buiten de box valt.

ASSETS HTTP API assets-http-api

De Assets HTTP-API omvat:

De huidige implementatie van Assets HTTP API is gebaseerd op de REST architecturale stijl en laat u toe om tot inhoud toegang te hebben (die in AEM wordt opgeslagen) via CRUD verrichtingen (creeer, Gelezen, Update, Schrapping).

Met deze bewerking kunt u met de API Adobe Experience Manager gebruiken als een CMS zonder kop (Content Management System) door Content Services aan te bieden aan een JavaScript front end-toepassing. Of elke andere toepassing die HTTP-aanvragen kan uitvoeren en JSON-reacties kan verwerken. Toepassingen van één pagina (SPA), op basis van framework of aangepast, vereisen bijvoorbeeld inhoud die via een API wordt aangeboden, vaak in JSON-indeling.

Assets HTTP API- en inhoudsfragmenten assets-http-api-content-fragments

Inhoudsfragmenten worden gebruikt voor levering zonder kop en een inhoudsfragment is een speciaal type element. Ze worden gebruikt om onder andere toegang te krijgen tot gestructureerde gegevens, zoals teksten, getallen, datums.

De Assets REST API gebruiken using-aem-assets-rest-api

Toegang access

De Assets REST-API gebruikt het /api/assets -eindpunt en vereist het pad van het element om het te openen (zonder de regelafstand /content/dam ).

Als u bijvoorbeeld toegang wilt krijgen tot /content/dam/wknd/en/adventures/cycling-tuscany , vraagt u om /api/assets/wknd/en/adventures/cycling-tuscany.json

Bewerking operation

De HTTP-methode bepaalt de uit te voeren bewerking:

De exacte indeling van ondersteunde aanvragen wordt gedefinieerd in de API-naslagdocumentatie.

Het gebruik kan verschillen, afhankelijk van het feit of u een AEM-auteur of -publicatieomgeving gebruikt en van uw specifieke gebruiksscenario.

Lezen/Levering read-delivery

Gebruik gebeurt via:

GET /{cfParentPath}/{cfName}.json

Bijvoorbeeld:

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

De reactie is geserialiseerd met JSON met de inhoud gestructureerd zoals in het inhoudsfragment. Referenties worden als referentie-URL's geleverd.

Er zijn twee typen leesbewerkingen mogelijk:

Maken create

Gebruik gebeurt via:

POST /{cfParentPath}/{cfName}

De hoofdtekst moet een JSON-representatie bevatten van het inhoudsfragment dat moet worden gemaakt, inclusief de initiële inhoud die moet worden ingesteld op de elementen van het inhoudsfragment. Het is verplicht de eigenschap cq:model in te stellen en deze moet verwijzen naar een geldig inhoudsfragmentmodel. Als u dit niet doet, treedt er een fout op. U moet ook een koptekst Content-Type toevoegen die is ingesteld op application/json .

Bijwerken update

Gebruik is via

PUT /{cfParentPath}/{cfName}

De hoofdtekst moet een JSON-representatie bevatten van wat voor het opgegeven inhoudsfragment moet worden bijgewerkt.

Dit kan gewoon de titel of beschrijving zijn van een inhoudsfragment, of één element, of alle elementwaarden en/of metagegevens.

Verwijderen delete

Gebruik gebeurt via:

DELETE /{cfParentPath}/{cfName}

Voor meer informatie over het gebruik van de AEM Assets REST API kunt u verwijzen naar:

Volgende functies whats-next

Nu u dit deel van de AEM Headless Developer Journey hebt voltooid, moet u:

U zou uw reis zonder kop van AEM door het document moeten voortzetten te herzien hoe te met Uw Zwaardeloze Toepassinggaan waar u eigenlijk uw project van AEM Zwaardeloos neemt levende!

Aanvullende bronnen additional-resources