APIs do AEM para entrega e gerenciamento de conteúdo estruturado aem-apis-structured-content-delivery-and-management

Entrega de fragmento de conteúdo do AEM com OpenAPI

• Essa API cria respostas JSON para fornecer conteúdo estruturado de fragmentos de conteúdo no AEM.
• Ele usa um caminho para um fragmento de conteúdo como endpoint.
• Essa API é baseada em REST.
• Ele é otimizado para entrega de conteúdo, incluindo integração de CDN.

API do AEM GraphQL para entrega de fragmentos de conteúdo

• Essa API é baseada em esquemas. Os esquemas de API são representados por Modelos de fragmento de conteúdo, que definem a estrutura do conteúdo.
• Essa API é baseada no GraphQL.

Fragmentos de conteúdo e OpenAPIs de modelos de fragmento de conteúdo

• Essas APIs são destinadas ao gerenciamento de conteúdo estruturado.
• Os respectivos operadores do GET não estão otimizados para a entrega de conteúdo.
• Essa API é baseada em REST.

Simplicidade

• Os desenvolvedores estão (geralmente) familiarizados com HTTP e REST. De acordo com o Estado Postman do relatório de APIs, uma alta porcentagem de desenvolvedores usam REST.

• Com simplicidade vem a familiaridade. Com o REST, não há perguntas organizacionais sobre quem é o proprietário das consultas e quem é o proprietário do aplicativo, enquanto essas perguntas podem surgir com o GraphQL.

• Com familiaridade (normalmente), existe uma ampla comunidade e um cenário de ferramentas. Não é uma desvantagem inerente do GraphQL, mas provavelmente será mais ampla e profunda para REST.

• A abordagem mais simples também pode facilitar a implementação da segurança. Com REST, a filtragem para determinar o conteúdo para renderizar tudo acontece no aplicativo cliente. Com o GraphQL, isso acontece em uma consulta baseada em esquema entre cliente e servidor.

Flexibilidade

• Com REST, o desenvolvedor pode GET qualquer recurso. Com o GraphQL, eles são limitados a recursos definidos em um esquema.

Armazenamento em cache

• As respostas JSON para solicitações REST GET são inerentemente armazenáveis em cache. As solicitações do GraphQL POST não podem ser armazenadas em cache, a menos que sejam feitas assim; por exemplo, usando as Consultas AEM persistidas armazenadas no servidor e solicitadas com solicitações GET semelhantes a REST.

Eficiência da entrega de conteúdo

• Foco

  • Com o GraphQL, os aplicativos cliente podem solicitar o conteúdo exato que precisam para renderização - e não mais. Essa abordagem evita a entrega excessiva de conteúdo, com cargas úteis excessivas de conteúdo e consumo desnecessário de largura de banda.

• Endpoint único

  • Enquanto no REST cada solicitação de API é um endpoint, no GraphQL há apenas um endpoint comum e solicitações de conteúdo diferentes são expressas como consultas usando esse endpoint comum.

Prototipagem rápida

• Com o GraphQL, esse é um processo de uma etapa, reunido na query do GraphQL, e pode facilitar a criação de protótipos. O REST, por outro lado, é um processo de duas etapas:

  1. Buscar conteúdo com a API.
  2. Na resposta JSON, determine o que usar para renderização no aplicativo do cliente.