#F5F5F5

Entregue conteúdo estruturado para qualquer aplicativo com a API GraphQL de conteúdo.

#F5F5F5

Acelere a distribuição de conteúdo omnicanal usando a API GraphQL e o Adobe Experience Manager Sites.

O Adobe Experience Manager Sites inclui integração nativa à API GraphQL para que desenvolvedores simplifiquem a distribuição de conteúdo estruturado em sites, aplicativos e outros canais digitais. Dessa maneira, equipes podem ampliar as operações de conteúdo, além de atender à crescente demanda por experiências dinâmicas e personalizadas.

A API GraphQL simplifica a distribuição de conteúdo.

As APIs REST antigas costumam sobrecarregar aplicativos com várias chamadas de servidor ou cargas excessivas de dados, reduzindo o desempenho e complicando o desenvolvimento. O Experience Manager Sites soluciona isso com uma API GraphQL nativa, permitindo que equipes de front-end solicitem exatamente o conteúdo desejado em uma consulta única e eficiente.

Como o CMS corporativo preferido do setor, o Experience Manager Sites combina gerenciamento de conteúdo estruturado com recursos modernos de distribuição. Sua integração ao GraphQL elimina estruturas rígidas de ponto de acesso, permitindo uma distribuição de conteúdo dimensionável e de alto desempenho para sites, aplicativos e experiências digitais.

Desenvolvida para as arquiteturas combináveis de hoje, a API GraphQL do Experience Manager Sites acelera o carregamento de páginas, agiliza o desenvolvimento e proporciona a flexibilidade necessária para que empresas atendam às novas demandas de clientes, tudo isso com precisão e em grande escala.

A integração da API GraphQL melhora a criação de conteúdo.

A API GraphQL no Experience Manager foi desenvolvida para expor conteúdo estruturado, especialmente fragmentos de conteúdo, para entrega headless em qualquer canal digital. Como um único endpoint flexível, a API permite que aplicações cliente busquem exatamente o que precisam, quando precisam.

Essa abordagem moderna e baseada em gráficos oferece vantagens claras sobre os antigos métodos REST:

  • Eficiência. Recupere estruturas de conteúdo complexas e aninhadas em uma única chamada de API, sem precisar encadear vários endpoints. Isso simplifica o desenvolvimento e acelera o carregamento das páginas.
  • Precisão. Desenvolvedores consultam apenas os campos necessários, reduzindo o tamanho do payload e melhorando o desempenho, especialmente em redes móveis.
  • Flexibilidade. A API GraphQL é independente de front-end, o que permite que equipes desenvolvam com qualquer framework (React, Angular, Vue e outros) sem ficar limitadas a SDKs proprietários.

API GraphQL e API REST antiga.

Recurso

API GraphQL do Experience Manager

API REST antiga

Estrutura de ponto de acesso
Normalmente, um ponto de acesso GraphQL unificado por configuração.
Vários pontos de acesso por recurso ou caso de uso.
Busca de dados
O cliente especifica os campos exatos necessários na consulta.
O servidor define uma estrutura de dados fixa por ponto de acesso.
Busca excessiva ou insuficiente
Evitado, retornando dados precisos.
Problema comum: pode retornar muitos ou poucos dados.
Volume de solicitação
Recupera dados relacionados (fragmentos aninhados) em uma só solicitação.
Geralmente requer várias solicitações para coletar dados relacionados.
Armazenamento em cache (solicitação padrão)
Solicitações POST normalmente não são armazenadas em cache por intermediários.
Solicitações GET são fáceis de armazenar em cache.
Armazenamento em cache (prática do Experience Manager)
Consultas persistentes permitem solicitações GET armazenáveis em cache.
Solicitações GET são fáceis de armazenar em cache.
Evolução da API
O sistema pode evoluir, sendo fácil adicionar campos não separáveis.
A adição de campos pode ser instável, muitas vezes exigindo controle de versões.

Principais recursos de GraphQL no Experience Manager Sites.

A integração da API GraphQL ao Experience Manager Sites inclui diversos recursos importantes:

Geração de esquema GraphQL.

O Experience Manager Sites simplifica o desenvolvimento headless, pois gera automaticamente esquemas GraphQL a partir de modelos de fragmento de conteúdo, eliminando a necessidade de criar esquemas manualmente. À medida que arquitetos de conteúdo definem ou atualizam os modelos, o Experience Manager transforma instantaneamente as mudanças em um esquema GraphQL dinâmico e tipificado no ponto de acesso correspondente.

Essa geração de esquema dinâmica oferece vantagens corporativas:

  • Tipagem forte e validação antecipada. A tipagem aplicada pelo schema garante resultados previsíveis e identifica consultas inválidas antes da execução, economizando tempo e reduzindo erros durante o desenvolvimento.
  • Introspecção nativa. Desenvolvedores podem consultar o próprio schema, habilitando recursos como autocompletar, validação e documentação inline com as ferramentas do GraphQL.
  • Consistência orientada ao conteúdo. O schema reflete a estrutura real do conteúdo, funcionando como fonte única de verdade. Esse alinhamento estreito entre autores e desenvolvedores agiliza a colaboração e elimina desvios no schema.

Ao automatizar a geração de esquemas, o Experience Manager Sites acelera compilações headless, reduz a sobrecarga de manutenção e cria uma ponte entre conteúdo estruturado e distribuição dimensionável.

Consulte exatamente o que precisa com GraphQL.

O GraphQL oferece às aplicações cliente controle total sobre a estrutura e a especificidade das solicitações de conteúdo. No Experience Manager Sites, desenvolvedores usam consultas GraphQL para recuperar com eficiência conteúdo estruturado a partir de fragmentos de conteúdo, de acordo com as necessidades da aplicação. As principais funcionalidades incluem:

  • Seleção de campos. Recupere apenas os campos necessários, sem nada além disso, minimizando o tamanho do payload e aumentando o desempenho.
  • Acesso direcionado a fragmentos. Consulte fragmentos de conteúdo individuais por caminho ou retorne listas por tipo de modelo.
  • Filtragem avançada. Refine os resultados aplicando filtros aos valores dos campos.
  • Recuperação de conteúdo aninhado. Busque fragmentos de conteúdo aninhados ou vinculados em uma única consulta, ideal para relacionamentos de conteúdo complexos.
  • Conteúdo localizado e com variantes. Solicite variações específicas de um fragmento para oferecer experiências personalizadas, regionais ou específicas por canal.
  • Consultas dinâmicas com variáveis. Insira valores como IDs ou termos de pesquisa em tempo de execução para criar consultas flexíveis e reutilizáveis sem precisar reescrever a estrutura.

Com o GraphQL no Sites, desenvolvedores trabalham em uma interface avançada e intuitiva com acesso headless a conteúdo, que proporciona velocidade, escalabilidade e precisão.

Configuração segura e dimensionável de pontos de acesso GraphQL.

No Experience Manager Sites, consultas GraphQL são enviadas a pontos de acesso designados: URLs específicos para a distribuição headless de conteúdo. Ao contrário de APIs REST, que têm vários pontos de contato para diferentes recursos, o GraphQL centraliza as interações por meio de um só ponto de acesso por configuração, simplificando o desenvolvimento e aprimorando a manutenibilidade.

Para garantir uma governança adequada, os pontos de acesso GraphQL no Sites devem ser configurados, ativados e publicados explicitamente por um administrador. Essa abordagem reforça a segurança e o controle antes de expor conteúdo estruturado. O Sites aceita dois tipos de pontos de acesso GraphQL:

  • Endpoint global. Concede acesso aos Modelos de fragmento de conteúdo definidos na configuração global, junto com modelos de qualquer configuração específica do site. Ideal para estruturas de conteúdo compartilhadas e reutilizadas entre projetos.
  • Endpoint específico do site. Vinculado a um site ou configuração de projeto específico, este endpoint restringe o acesso apenas aos modelos dessa configuração, mais os do escopo global, proporcionando isolamento claro e minimizando a exposição entre projetos.

Essa opção flexível permite que empresas gerenciem a distribuição de conteúdo entre marcas, regiões nem unidades de negócio com precisão, proporcionando escalabilidade sem abrir mão da segurança ou da clareza.

Navegação até um ponto de acesso GraphQL

Perguntas frequentes

Qual é a diferença entre APIs GraphQL e APIs REST?
GraphQL é uma linguagem de consulta moderna para APIs que permite que clientes solicitem exatamente os dados necessários a partir de um só ponto de acesso. APIs REST, por outro lado, dependem de vários pontos de acesso e estruturas fixas de dados. Portanto, GraphQL é uma opção mais eficiente, flexível e ideal para aplicativos dinâmicos e ricos em conteúdo.

Saiba mais sobre a API GraphQL.

Content as a Service v3 - experience-manager-sites - Wednesday, May 21, 2025 at 13:55