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.
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:
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
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.
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.
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.
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)
Saiba como criar um Aplicativo de página única (SPA) que busca conteúdo do AEM usando APIs do GraphQL.
Saiba como criar um aplicativo móvel que busque conteúdo do AEM usando APIs do GraphQL.
Saiba como criar um componente da Web que busque conteúdo do AEM usando APIs do GraphQL.
RESTful APIs - Exemplos
Saiba mais sobre as APIs RESTful, como API HTTP do Assets e Exportador JSON.
Casos de uso
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.
Autenticação baseada em token para APIs RESTful
Saiba como invocar APIs RESTful usando autenticação JSON Web Token (JWT).