Rechercher dans l’API Assets

Dernière mise à jour : 22 mars 2025

Créé pour :

  • Utilisateur ou utilisatrice
Nouveau Dynamic Media Prime et UltimateNouveau AEM Assets UltimateNouvelle Intégration d’AEM Assets à Edge Delivery ServicesNouveau Extensibilité de l’interface utilisateurNouveau Activation de Dynamic Media Prime et Ultimate
Bonnes pratiques de rechercheBonnes pratiques relatives aux métadonnéesHub de contenusFonctionnalités Dynamic Media avec OpenAPIDocumentation de développement pour AEM Assets
AVAILABILITY
Le guide de Dynamic Media avec fonctionnalités OpenAPI est désormais disponible au format PDF. Téléchargez l’intégralité du guide et utilisez l’assistant IA Adobe Acrobat pour répondre à vos requêtes.

Toutes les ressources approuvées disponibles dans le référentiel de ressources d’Experience Manager peuvent être recherchées, puis diffusées vers les applications intégrées en aval à l’aide d’une URL de diffusion.

La recherche des ressources approuvées appropriées dans le référentiel Experience Manager est la première étape de la diffusion des ressources à l’aide de l’URL de diffusion. La réponse à la requête de recherche comprend un tableau de documents JSON correspondant aux ressources qui répondaient aux critères de recherche. Chaque document JSON est identifié à l’aide d’un champ id, qui est utilisé pour composer la demande de diffusion de ressources.

Présentation du protocole de chargement binaire direct

Vous pouvez définir des propriétés dans la requête de l’API Search Assets pour activer les fonctionnalités suivantes :

  • Recherche en texte intégral : utilisez la requête match pour définir le texte à rechercher. Vous pouvez également utiliser des opérateurs dans la requête match pour filtrer les résultats.

  • Appliquer des filtres : utilisez la requête term pour filtrer davantage les résultats en définissant un key et une ou plusieurs valeurs. key identifie le champ dont la valeur doit être mise en correspondance et value représente ce en quoi il faut mettre en correspondance. De même, vous pouvez utiliser la requête range pour définir une plage pour un champ à l’aide des propriétés Supérieur à (gt), Supérieur ou égal à (gte), Inférieur à (lt) et Inférieur ou égal à (lte).

  • Trier les résultats : utilisez la propriété OrderBy pour trier les résultats de recherche en fonction d’un ou de plusieurs champs. Vous pouvez trier les résultats par ordre croissant ou décroissant.

  • Pagination : utilisez les propriétés limit et cursor pour définir les propriétés de pagination dans une requête de l’API de recherche. limit propriété définit le nombre maximal d’éléments à récupérer dans une réponse API. cursor propriété facilite la récupération du point de départ pour l’ensemble suivant de ressources définies dans la propriété limit . Par exemple, si vous définissez 50 comme limite dans la requête API, vous pouvez utiliser la propriété cursor pour démarrer et récupérer les 50 éléments suivants à l’aide de la requête API suivante.

Rechercher le point d’entrée de l’API Assets

Le point d’entrée d’une requête d’API de ressources de recherche doit être au format suivant :
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/search

Le domaine de diffusion est similaire, par sa structure, au domaine de l’environnement de création Experience Manager. La seule différence est de remplacer le terme author par delivery.

pXXXX fait référence à l’ID de programme

eYYYY fait référence à l’identifiant d’environnement

Méthode de requête de l’API Rechercher des ressources

POST

Rechercher l’en-tête de l’API Assets

Vous devez fournir les détails suivants lors de la définition d’un en-tête dans l’API Rechercher des ressources :

headers: {
      'Content-Type': 'application/json',
      'X-Adobe-Accept-Experimental': '1',
      Authorization: 'Bearer <YOUR_JWT_HERE>',
      'X-Api-Key': 'YOUR_API_KEY_HERE'
    },

Pour appeler l’API Search, un jeton IMS est nécessaire pour définir dans les détails de la Authorization. Le jeton IMS est récupéré à partir d’un compte technique. Voir Récupérer les informations d’identification AEM as a Cloud Service pour créer un compte technique. Voir Génération du jeton d’accès pour générer le jeton IMS et l’utiliser correctement dans l’en-tête de la requête de l’API Search Assets.

Pour afficher des exemples de requête, des exemples de réponse et des codes de réponse, voir Rechercher l’API Assets.

Experience Manager