Vue d’ensemble des API AEM aem-apis-overview

Découvrez les différents types d’API dans Adobe Experience Manager (AEM) et déterminez quelle API choisir pour votre intégration.

Pour créer, lire, mettre à jour et supprimer du contenu, des ressources et des formulaires dans AEM, les développeurs et développeuses peuvent utiliser un large éventail d’API. Ces API permettent aux développeurs et développeuses de créer des applications personnalisées qui interagissent avec AEM.

Explorons les différents types d’API dans AEM et comprenons quelle API choisir pour votre intégration.

Types d’API AEM types-of-aem-apis

AEM propose les API suivantes pour interagir avec ses types de services de création et de publication.

Type d’API AEM
Description
Disponibilité
Cas d’utilisation
Exemples d’API
API AEM basées sur OpenAPI
API normalisées et lisibles par machine pour Assets, Sites et Forms.
AEM as a Cloud Service uniquement
Développement axé sur les API, applications modernes
API de création Assets, Dossiers API, API AEM Sites, API Forms Document Services, etc.
API RESTful
Points d’entrée REST traditionnels pour interagir avec les ressources AEM.
AEM 6.X, AEM as a Cloud Service
Opérations CRUD, applications modernes
API HTTP Assets, API REST Workflow, Exportateur JSON pour Content Services, etc.
API GraphQL
Optimisées pour récupérer efficacement du contenu structuré avec des requêtes flexibles.
AEM 6.X, AEM as a Cloud Service
CMS découplé, SPA, applications mobiles
API GraphQL
API traditionnelles (autres que RESTful)
API plus anciennes comme JCR, modèles Sling, Query Builder, etc.
AEM 6.X, AEM as a Cloud Service
Intégrations héritées, rétrocompatibilité
API Query Builder et autres

Pour plus d’informations, consultez la page API Adobe Experience Manager as a Cloud Service.

Quelle API choisir which-api-to-choose

Lors de la sélection d’une API pour votre intégration, tenez compte des facteurs suivants :

  • Cas d’utilisation : déterminez si l’API AEM prend en charge votre cas d’utilisation. Dans la mesure du possible, utilisez des API AEM basées sur OpenAPI, car elles offrent une approche normalisée et moderne de l’interaction avec AEM. Si les API OpenAPI ne sont pas disponibles, envisagez d’utiliser des API RESTful ou des API GraphQL et, en dernier recours, des API traditionnelles.

  • Compatibilité : assurez-vous que l’API sélectionnée est compatible avec votre version d’AEM. Par exemple, les API AEM basées sur OpenAPI sont exclusives à AEM as a Cloud Service et ne sont pas disponibles dans AEM 6.X.

  • Type de service AEM : création ou publication : le choix de l’API dépend également de son exécution sur le service de création ou de publication, car leurs modèles d’accès sont différents. Le service de création AEM est utilisé pour la création de contenu et requiert toujours une authentification. Le service de publication AEM est utilisé pour la diffusion de contenu et peut ne pas nécessiter d’authentification, selon le cas d’utilisation.

  • Authentification : vérifiez que l’API prend en charge la méthode d’authentification que vous prévoyez d’utiliser. Par exemple :

    • API AEM basées sur OpenAPI : prennent en charge l’authentification OAuth 2.0, y compris les types d’octroi Informations d’identification clientes (serveur à serveur), Code d’autorisation (application web) et Clé de BAT pour l’échange de code (application d’une seule page). Les autres API d’AEM ne prennent pas en charge l’authentification OAuth 2.0.
    • API RESTful : prennent en charge l’authentification par jeton web JSON (JWT), également appelée authentification par jeton.

Différence entre le jeton web JSON (JWT) et OAuth 2.0 difference-between-jwt-and-oauth

Comparons le jeton web JSON (JWT) et OAuth 2.0, deux mécanismes d’authentification courants utilisés dans les API AEM :

Fonctionnalité
Jeton web JSON (JWT)
OAuth 2.0
Utilisé dans
API RESTful
API AEM basées sur OpenAPI (non prises en charge par les API RESTful ou autres)
Objectif
Authentification du service
Authentification de l’utilisateur ou de l’utilisatrice ou du service
Interaction de l’utilisateur ou de l’utilisatrice
Aucune interaction de l’utilisateur ou de l’utilisatrice requise
Interaction de l’utilisateur ou l’utilisatrice requise pour les types d’octroi Code d’autorisation et Application d’une seule page
Mieux adapté à
Appels API serveur à serveur
Accès sécurisé et autorisé pour les applications et les utilisateurs et utilisatrices
Informations requises
Clé privée pour la signature du JWT
ID client et secret client pour OAuth 2.0
Expiration du jeton
De courte durée, nécessite souvent une actualisation.
Le jeton d’accès est de courte durée. Le jeton d’actualisation est de longue durée et utilisé pour obtenir un nouveau jeton d’accès.
Gestion des informations d’identification
AEM Developer Console.
Adobe Developer Console

API AEM basées sur OpenAPI

Pour en savoir plus sur les API AEM basées sur OpenAPI et les concepts importants de l’accès aux API Adobe, consultez le guide API AEM basées sur OpenAPI.

Cas d’utilisation

Appeler l’API à l’aide de l’authentification de serveur à serveur

Appeler l’API à l’aide de l’authentification de serveur à serveur

Découvrez comment appeler les API AEM basées sur OpenAPI à partir d’une application NodeJS personnalisée à l’aide de l’authentification de serveur à serveur OAuth.

En savoir plus

Appeler l’API à l’aide de l’authentification de l’application web

Appeler l’API à l’aide de l’authentification d’application web

Découvrez comment appeler les API AEM basées sur OpenAPI à partir d’une application web personnalisée à l’aide de l’authentification de l’application Web OAuth.

En savoir plus

Appeler l’API à l’aide de l’application d’une seule page OAuth

Appeler l’API à l’aide de l’application d’une seule page OAuth

Découvrez comment appeler les API AEM basées sur OpenAPI à partir d’une application d’une seule page (SPA) personnalisée à l’aide du flux PKCE OAuth 2.0.

En savoir plus

API GraphQL - Exemples

Pour en savoir plus sur les API GraphQL et leur utilisation, voir Prise en main d’AEM Headless - GraphQL

Cas d’utilisation

Application d’une seule page (SPA)

Application d’une seule page (SPA)

Découvrez comment créer une application d’une seule page (SPA) qui récupère du contenu d’AEM à l’aide d’API GraphQL.

En savoir plus

Application mobile

Application mobile

Découvrez comment créer une application mobile qui récupère du contenu d’AEM à l’aide d’API GraphQL.

En savoir plus

Composant web

Composant web

Découvrez comment créer un composant web qui récupère du contenu d’AEM à l’aide d’API GraphQL.

En savoir plus

API RESTful - Exemples

En savoir plus sur les API RESTful, telles que l’API HTTP Assets et l’exportateur JSON.

Cas d’utilisation

Utilisation de Content Services pour l’application découplée

Utilisation de Content Services pour l’application découplée

Découvrez comment créer une application mobile native qui récupère du contenu d’AEM à l’aide des API RESTful Content Services.

En savoir plus

Authentification basée sur les jetons pour les API RESTful

Authentification basée sur les jetons pour les API RESTful

Découvrez comment appeler les API RESTful à l’aide de l’authentification par jeton web JSON (JWT).

En savoir plus

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