Visão geral das APIs do AEM aem-apis-overview

Saiba mais sobre os diferentes tipos de APIs no Adobe Experience Manager (AEM) e entenda qual API escolher para sua integração.

Para criar, ler, atualizar e excluir conteúdo, ativos e formulários no AEM, os desenvolvedores podem usar uma grande variedade de APIs. Essas APIs permitem que os desenvolvedores criem aplicativos personalizados que interagem com o AEM.

Vamos explorar os diferentes tipos de APIs no AEM e entender qual API escolher para sua integração.

Tipos de APIs do AEM types-of-aem-apis

O AEM oferece as seguintes APIs para interagir com seus tipos de serviço de autoria e publicação.

Tipo de API do AEM
Descrição
Disponibilidade
Caso de uso
Exemplos de API
APIs do AEM baseadas em OpenAPI
APIs padronizadas e legíveis por máquina para Assets, Sites e Forms.
Somente AEM as a Cloud Service
Desenvolvimento de API First, aplicativos modernos
API do Autor do Assets, API de Pastas, API do AEM Sites, API de Serviços de Documentos do Forms e outros
APIs RESTful
Endpoints REST tradicionais para interação com recursos do AEM.
AEM 6.X, AEM as a Cloud Service
Operações CRUD, aplicativos modernos
API HTTP do Assets, API REST do fluxo de trabalho, Exportador JSON para Serviços de Conteúdo e outros
APIs do GraphQL
Otimizado para recuperar conteúdo estruturado com eficiência com consultas flexíveis.
AEM 6.X, AEM as a Cloud Service
CMS headless, SPAs, aplicativos móveis
API GraphQL
APIs tradicionais (não RESTful)
APIs mais antigas, como JCR, Modelos Sling, Construtor de consultas e outras.
AEM 6.X, AEM as a Cloud Service
Integrações herdadas, compatibilidade com versões anteriores
API do Construtor de Consultas e outras

Para obter mais detalhes, consulte a página APIs do Adobe Experience Manager as a Cloud Service.

Qual API escolher which-api-to-choose

Ao selecionar uma API para sua integração, considere os seguintes fatores:

  • Caso de uso: determine se a API do AEM oferece suporte ao seu caso de uso. Sempre que possível, use APIs do AEM baseadas em OpenAPI, pois elas fornecem uma abordagem moderna e padronizada para interagir com o AEM. Se as APIs baseadas em OpenAPI não estiverem disponíveis, considere usar APIs RESTful ou APIs do GraphQL e, como último recurso, APIs tradicionais.

  • Compatibilidade: verifique se a API selecionada é compatível com sua versão do AEM. Por exemplo, as APIs do AEM baseadas em OpenAPI são exclusivas do AEM as a Cloud Service e não estão disponíveis no AEM 6.X.

  • Tipo de serviço do AEM: Autor vs. Publicação: a escolha da API também depende se ela é executada no serviço Autor ou Publicação, já que seus modelos de acesso são diferentes. O serviço do Autor do AEM é usado para criação de conteúdo e sempre requer autenticação. O serviço de Publicação do AEM é usado para entrega de conteúdo e pode não exigir autenticação, dependendo do caso de uso.

  • Autenticação: verifique se a API dá suporte ao método de autenticação que você planeja usar. Por exemplo:

    • APIs do AEM baseadas em OpenAPI: oferecem suporte à autenticação OAuth 2.0, incluindo os tipos de concessão Credenciais de Cliente (Servidor para Servidor), Código de Autorização (Aplicativo Web) e Chave de Prova para Troca de Código (Aplicativo de Página Única). Outras APIs do AEM não são compatíveis com a autenticação OAuth 2.0.
    • APIs RESTful: suporta a autenticação JSON Web Token (JWT), também conhecida como autenticação baseada em token.

Diferença entre o JSON Web Token (JWT) e o OAuth 2.0 difference-between-jwt-and-oauth

Vamos comparar o JSON Web Token (JWT) e o OAuth 2.0, dois mecanismos de autenticação comuns usados nas APIs do AEM:

Destaque
JSON Web Token (JWT)
OAuth 2.0
Usado em
APIs RESTful
APIs do AEM baseadas em OpenAPI (não compatíveis com RESTful ou outras APIs)
Propósito
Autenticação de serviço
Autenticação de usuário ou serviço
Interação do usuário
Não é necessária nenhuma interação com o usuário
Interação do usuário necessária para os tipos de concessão Código de autorização e Aplicativo de página única
Mais adequado para
Chamadas de API de servidor para servidor
Acesso seguro e permitido para aplicativos e usuários
Informações necessárias
Chave privada para assinatura do JWT
ID do cliente e segredo do cliente para OAuth 2.0
Expiração do token
De vida curta, geralmente precisa de atualização
O token de acesso tem vida curta. O token de atualização tem vida longa e é usado para obter um novo token de acesso
Gerenciamento de credenciais
AEM Developer Console
Adobe Developer Console

APIs do AEM baseadas em OpenAPI

Saiba mais sobre as APIs do AEM baseadas em OpenAPI e os conceitos importantes de acesso às APIs do Adobe no guia de APIs do AEM baseadas em OpenAPI.

Casos de uso

Chamar API usando autenticação de servidor para servidor

Invocar API usando autenticação de Servidor para Servidor

Saiba como chamar APIs do AEM baseadas em OpenAPI de um aplicativo NodeJS personalizado usando a autenticação de servidor para servidor do OAuth.

                    Saiba mais

Chamar API usando autenticação do Aplicativo Web

Invocar API usando autenticação de Aplicativo Web

Saiba como chamar APIs do AEM baseadas em OpenAPI de um aplicativo web personalizado usando a autenticação do OAuth Web App.

                    Saiba mais

Chamar API usando o aplicativo de página única OAuth

Invocar API usando o aplicativo de página única OAuth

Saiba como chamar APIs do AEM baseadas em OpenAPI de um aplicativo de página única (SPA) personalizado usando o fluxo de PKCE do OAuth 2.0.

                    Saiba mais

APIs do GraphQL - Exemplos

Saiba mais sobre as APIs do GraphQL e como usá-las na Introdução ao AEM Headless - GraphQL

Casos de uso

Aplicativo de página única (SPA)

Aplicativo de Página Única (SPA)

Saiba como criar um Aplicativo de página única (SPA) que busca conteúdo do AEM usando APIs do GraphQL.

                    Saiba mais

Aplicativo móvel

Aplicativo móvel

Saiba como criar um aplicativo móvel que busque conteúdo do AEM usando APIs do GraphQL.

                    Saiba mais

Componente da Web

Componente da Web

Saiba como criar um componente da Web que busque conteúdo do AEM usando APIs do GraphQL.

                    Saiba mais

RESTful APIs - Exemplos

Saiba mais sobre as APIs RESTful, como API HTTP do Assets e Exportador JSON.

Casos de uso

Uso do Content Services para aplicativos headless

Usando os Serviços de Conteúdo para o Aplicativo Headless

Saiba como criar um aplicativo móvel nativo que busque conteúdo do AEM usando as APIs RESTful do Content Services.

                    Saiba mais

Autenticação baseada em token para APIs RESTful

Autenticação baseada em token para APIs RESTful

Saiba como invocar APIs RESTful usando autenticação JSON Web Token (JWT).

                    Saiba mais

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69