Como atualizar seu conteúdo por meio das APIs do AEM Assets update-your-content

Nesta parte da jornada do desenvolvedor headless do AEM, saiba como usar a API REST para acessar e atualizar o conteúdo dos seus fragmentos de conteúdo.

A história até agora story-so-far

No documento anterior da jornada headless do AEM, Como acessar seu conteúdo por meio das APIs de entrega do AEM, você aprendeu a acessar o conteúdo headless no AEM por meio da API GraphQL do AEM; agora você deve:

Este artigo se baseia nesses fundamentos para que você entenda como atualizar o seu conteúdo headless existente no AEM por meio da API REST.

Objetivo objective

Por que você precisa da API HTTP de ativos para fragmentos de conteúdo why-http-api

No estágio anterior da jornada headless, você aprendeu como usar a API GraphQL do AEM para recuperar o conteúdo usando consultas.

Então, por que é necessária outra API?

A API HTTP do Assets não permite Ler seu conteúdo, mas também permite Criar, Atualizar e Excluir conteúdo - ações que não são possíveis com a API do GraphQL.

A API REST de ativos está disponível em cada instalação pronta para uso de versões recentes do Adobe Experience Manager as a Cloud Service.

API HTTP de ativos assets-http-api

A API HTTP de ativos abrange:

A implementação atual da API HTTP de ativos é baseada no estilo de arquitetura REST e permite que você acesse o conteúdo (armazenado no AEM) por meio de operações CRUD (criar, ler, atualizar, excluir).

Com essas operações, a API permite operar o Adobe Experience Manager as a Cloud Service como um CMS (Content Management System, Sistema de gerenciamento de conteúdo) headless, fornecendo Serviços de conteúdo a um aplicativo front-end JavaScript. Ou qualquer outro aplicativo que possa executar solicitações HTTP e manipular respostas JSON. Por exemplo, aplicativos de página única (SPA) baseados em estrutura ou personalizados exigem conteúdo fornecido por meio de uma API, geralmente no formato JSON.

API HTTP de ativos e fragmentos de conteúdo assets-http-api-content-fragments

Os fragmentos de conteúdo são usados para entrega headless e são um tipo especial de ativo. Eles são usados para acessar dados estruturados, como textos, números, datas, entre outros.

Uso da API REST de ativos using-aem-assets-rest-api

Acesso access

A API REST de ativos usa o ponto de acesso /api/assets e necessita do caminho do ativo para acessá-lo (sem o /content/dam inicial).

Por exemplo, para acessar /content/dam/wknd/en/adventures/cycling-tuscany, solicite /api/assets/wknd/en/adventures/cycling-tuscany.json

Operação operation

O método HTTP determina a operação a ser executada:

O formato exato das solicitações compatíveis é definido na documentação de Referência da API.

O uso pode ser diferente dependendo se você está usando um ambiente de autor ou de publicação no AEM, juntamente com seu caso de uso específico.

Leitura/entrega read-delivery

O uso é feito via:

GET /{cfParentPath}/{cfName}.json

Por exemplo:

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

A resposta é em JSON serializado e o conteúdo é estruturado de acordo com o fragmento de conteúdo. As referências são fornecidas como URLs de referência.

Dois tipos de operações de leitura são possíveis:

Criar create

O uso é feito via:

POST /{cfParentPath}/{cfName}

O corpo deve conter uma representação JSON do fragmento de conteúdo a ser criado, incluindo qualquer conteúdo inicial que deve ser definido nos elementos do fragmento de conteúdo. É obrigatório definir a propriedade cq:model e ela deve apontar para um modelo de fragmento de conteúdo válido. Se isso não for feito, haverá um erro. Também é necessário adicionar um cabeçalho Content-Type definido como application/json.

Atualizar o update

O uso é feito via

PUT /{cfParentPath}/{cfName}

O corpo deve conter uma representação JSON referente ao que deve ser atualizado para o fragmento de conteúdo especificado.

Isso pode ser simplesmente o título ou a descrição de um fragmento de conteúdo, um único elemento ou todos os valores e/ou metadados do elemento.

Excluir delete

O uso é por meio de:

DELETE /{cfParentPath}/{cfName}

Para obter mais detalhes sobre como usar a API REST do AEM Assets, consulte o seguinte:

O que vem a seguir whats-next

Agora que concluiu esta parte da jornada de desenvolvedores headless do AEM, você deve:

Você deve continuar a jornada headless do AEM revisando o documento Como unir os conceitos: aplicativo e conteúdo no AEM headless, onde você se familiarizará com as noções básicas e as ferramentas da arquitetura do AEM necessárias para unir seu aplicativo.

Recursos adicionais additional-resources