API basadas en OpenAPI
Las nuevas API de AEM as a Cloud Service siguen la especificación de OpenAPI y, por lo tanto, ofrecen un conjunto de API coherente y bien documentado.
NOTAEn el caso de los extremos que requieren autenticación, el método de autenticación difiere según el extremo, pero puede utilizar OAuth Servidor a servidor, OAuth Web App o OAuth Single Page App (SPA). Las credenciales se configuran mediante proyectos en Adobe Developer Console.
Los casos de uso comunes de la API implican integraciones con sistemas como CRM o PIM, donde las API de AEM se invocan para recuperar o mantener datos. Como parte de la implementación de la integración, las aplicaciones pueden suscribirse a eventos emitidos por AEM, que pueden almacenar en déclencheur la lógica empresarial en Adobe App Builder u otra infraestructura.
Este documento sirve como información general, pero hay documentación más detallada disponible en las siguientes páginas:
-
Los vínculos de la sección API basada en OpenAPI de documentación de referencia. La documentación de referencia de cada API también incluye un área de reproducción de API, lo que facilita la prueba de un extremo mediante un token de portador generado con Adobe Developer Console.
-
Guías de información, incluidos conceptos y sintaxis de API.
-
Un tutorial de nivel superior que describe enfoques de autenticación y otros conceptos.
-
Un tutorial con vídeo centrado en cómo configurar las API basadas en OpenAPI.
-
Un tutorial completo sobre la configuración y la invocación de OpenAPI con la estrategia de autenticación de servidor a servidor. También se pueden encontrar tutoriales similares para los enfoques de autenticación de Aplicación web y Aplicación de una sola página.
Configuración del acceso a API
Algunas API de AEM basadas en OpenAPI necesitan autenticación, lo que requiere que se generen credenciales con Adobe Developer Console. La configuración implica los siguientes pasos:
- Modernización del entorno de AEM as a Cloud Service.
- Habilite el acceso a las API de AEM mediante Perfiles de producto. Los perfiles de producto están asociados a los servicios que representan a los grupos de usuarios de AEM con listas de control de acceso (ACL) predefinidas. Aunque algunos servicios están asociados de manera predeterminada con perfiles de producto específicos, otros necesitan estar asociados explícitamente; por ejemplo, el servicio Usuarios de la API de AEM Assets no está asociado con ningún Perfil de producto, por lo que debe habilitarlo para que utilice la API de AEM Assets. Para obtener más información, consulte el paso del tutorial Habilitar el acceso a las API de AEM.
- Para añadir la autenticación de servidor a servidor, la integración de configuración del usuario debe ser el administrador del sistema de la organización en Adobe Admin Console o agregarse como desarrollador al perfil de producto donde está asociado el servicio. Para obtener más información, consulte el paso del tutorial Habilitar el acceso a las API de AEM.
- Crear un proyecto de Adobe Developer Console (ADC).
- Configure el proyecto ADC. Esto genera credenciales que se utilizarán más adelante para intercambiar un token de portador al invocar la API.
- Configure la instancia de AEM para habilitar la comunicación del proyecto ADC. Esto implica registrar el ID de cliente con el entorno mediante la configuración e implementación de un archivo YAML, tal como se describe en la sección Registro de un ID de cliente a continuación.
Para obtener instrucciones detalladas paso a paso, consulte el tutorial Configurar API basadas en OpenAPI.