#F5F5F5

Distribua conteúdo estruturado em grande escala com a API GraphQL.

#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 é projetada para expor conteúdo estruturado, principalmente fragmentos de conteúdo, para a distribuição headless em qualquer canal digital. A API permite que aplicativos cliente busquem exatamente o que precisam, no momento em que precisam, funcionando como um ponto de acesso único e flexível.

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 com uma só chamada de API, eliminando a necessidade de encadear vários pontos de acesso. Isso simplifica o desenvolvimento e acelera o carregamento das páginas.
  • Precisão. Desenvolvedores consultam apenas os campos necessários, reduzindo o volume de dados e melhorando o desempenho, especialmente em redes móveis.
  • Flexibilidade. A API GraphQL não depende de front-end, permitindo que equipes trabalhem usando qualquer estrutura, como React, Angular, Vue, entre outras, sem que sejam restritas 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:

  • Tipificação sólida e validação antecipada. A tipificação esquemática garante resultados previsíveis e identifica consultas inválidas antes da execução, poupando tempo e reduzindo erros durante o desenvolvimento.
  • Introspecção integrada. Desenvolvedores podem consultar o próprio esquema, permitindo recursos como preenchimento automático, validação e documentação em linha ao usar ferramentas de GraphQL.
  • Consistência orientada por conteúdo. O esquema reflete a estrutura do próprio conteúdo, funcionando como uma fonte única de verdade. Esse alinhamento estreito entre criadores e desenvolvedores simplifica a colaboração e elimina desvios do esquema.

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 a aplicativos cliente controle total sobre a estrutura e a especificidade das solicitações de conteúdo. No Experience Manager Sites, desenvolvedores realizam consultas GraphQL para recuperar com eficiência conteúdo estruturado de fragmentos de conteúdo, que são adaptados às necessidades de seus aplicativos. Os principais recursos incluem:

  • Seleção de campo. Recupere somente os campos necessários, reduzindo o volume de dados e melhorando o desempenho.
  • Acesso a fragmentos específicos. Consulte fragmentos de conteúdo individuais por caminho ou retorne listas por tipo de modelo.
  • Filtragem avançada. Limite os resultados aplicando filtros a valores de campos.
  • Recuperação de conteúdo aninhado. Busque fragmentos de conteúdo aninhados ou vinculados com uma só consulta, o que é ideal para relações complexas de conteúdo.
  • Conteúdo localizado e variado. Solicite variações específicas de um fragmento para proporcionar experiências personalizadas, por região ou por canal.
  • Consultas dinâmicas com variáveis. Injete valores como IDs ou termos de pesquisa durante a execução para criar consultas reutilizáveis e flexí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:

  • Ponto de acesso global. Concede acesso a modelos de fragmento de conteúdo definidos na configuração global, além de modelos de configurações específicas do site. Ideal para estruturas de conteúdo compartilhadas que são reutilizadas entre projetos.
  • Ponto de acesso por site. Vinculado à configuração específica de um projeto ou site, este método restringe o acesso a somente modelos dessa configuração em adição aos do escopo global, oferecendo isolamento claro e reduzindo 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