API pour les créateurs
Les API d’entreprise Adobe CX donnent aux développeurs et aux outils de codage assistés par l’IA un accès direct aux données et aux workflows d’Adobe. Utilisez-les pour créer des applications personnalisées, automatiser les intégrations et incorporer les fonctionnalités d’Adobe dans vos propres systèmes. Les API sont le bon choix lorsque vous avez besoin d’un contrôle programmatique complet sur une intégration système ou que vous créez une application sur les données d’Adobe. Pour un accès conversationnel piloté par un agent aux workflows Adobe, reportez-vous à la section Serveurs MCP.
API d’entreprise Adobe CX
Rapports, flux de données, mesures calculées et gestion des segments.
API REST et GraphQL pour le catalogue, le panier, les commandes, les clients et les promotions.
Opérations CRUD pour les jeux de données, les schémas, les profils, les identités, les requêtes et la segmentation.
orchestration des parcours, gestion des campagnes, modèles de contenu et Offer Decisioning.
API de gestion de contenu, de ressources et de workflows pour Adobe Experience Manager.
Workflows d’activation et de gestion des audiences.
SDK mobiles, SDK Edge et messagerie in-app.
Workflows d’accès aux données, de création de rapports et d’informations CJA.
Ingestion des données Edge Network, collecte d’événements en temps réel et diffusion de données en continu.
Configuration du projet API, authentification et gestion des informations d’identification.
Intégrations basées sur des événements, webhooks et triggers d’automatisation.
Workflows de confidentialité, gouvernance des données et requêtes des titulaires de données.
Gestion des utilisateurs, administration des identités et automatisation des comptes d’entreprise.
Créer avec des API
Les agents de codage tels que Claude Code, Cursor et OpenAI Codex sont adaptés à la création avec les API d’entreprise Adobe CX. Ajoutez une spécification OpenAPI à votre projet pour que l’agent puisse découvrir les points d’entrée, créer des requêtes et donner une raison sur le comportement de l’API sans câblage manuel. Pour commencer, deux éléments sont nécessaires : les informations d’identification authentifiées de Adobe Developer Console et l’ajout de la documentation de l’API à votre projet.
Configuration des informations d’identification d’API dans Adobe Developer Console
Tout accès à l’API d’entreprise Adobe CX est géré via Adobe Developer Console. Créez un projet, ajoutez les API dont votre application a besoin et générez des informations d’identification.
- Connectez-vous et créez un projet dans Adobe Developer Console.
- Ajoutez l’API pour l’application Adobe CX Enterprise dont vous avez besoin.
- Choisissez un type d’authentification. Utilisez OAuth de serveur à serveur pour les workflows automatisés ou OAuth Web App pour les applications orientées utilisateur.
- Générez vos informations d’identification. Notez l’ID client, le secret client et le point d’entrée du jeton à utiliser dans votre application.
La plupart des API d’entreprise Adobe CX nécessitent une licence d’application. Si une API n’est pas disponible dans votre projet Developer Console, contactez votre représentant Adobe.
Ajouter le contexte de l’API Adobe à votre projet
Les agents de codage de l’IA peuvent découvrir et utiliser de manière fiable les API Adobe lorsque vous ajoutez le matériel de référence approprié à votre projet. Cela fonctionne pour toute API d’entreprise Adobe CX qui publie une spécification OpenAPI.
1. Recherchez la spécification d’API
Parcourez les API Adobe CX Enterprise répertoriées ci-dessus ou accédez directement au catalogue d’API Adobe Developer.
2. Téléchargez la spécification OpenAPI
Créez un répertoire /specs dans votre projet. Téléchargez le YAML OpenAPI à partir de la page des références d’API sur developer.adobe.com et enregistrez-le. Ajoutez un README.md qui enregistre l’URL source et la date de téléchargement.
/specs/README.md
/specs/aem-assets.openapi.yaml
3. Générez un index API
Collez cette invite dans votre agent de codage, en remplaçant <API-SPEC-FILE> par votre nom de fichier :
Read /specs/<API-SPEC-FILE>.openapi.yaml and generate /docs/<API-SPEC-FILE>.api.md.
Create a concise API index for AI coding agents. For each operation include: operationId, HTTP method, path, purpose, authentication requirements, required inputs, response shape, common error responses, pagination behavior, asynchronous behavior, and deprecation status.
Do not invent endpoints, parameters, request bodies, response fields, or behavior not present in the OpenAPI specification.
4. Générez les instructions de l’agent
Read /specs/<API-SPEC-FILE>.openapi.yaml and /docs/<API-SPEC-FILE>.api.md.
Generate AGENTS.md. Instructions should:
- Treat the OpenAPI specification as the source of truth.
- Use the API index as a navigation guide.
- Never invent endpoints, parameters, response fields, or status codes.
- Prefer documented operationIds.
- Avoid deprecated or experimental APIs unless explicitly requested.
- Follow authentication requirements defined in the specification.
- Use the local OpenAPI snapshot for implementation decisions.
5. Vérifier
Demandez à votre agent de codage d’effectuer une tâche simple en utilisant uniquement les fichiers générés :
Write a function that takes an AEM asset ID and returns the asset title and description. Use only /specs/aem-assets.openapi.yaml and /docs/aem-assets.api.md.
Si l’agent l’effectue correctement sans inventer de comportement, la configuration est terminée.
Structure de projet recommandée
project/
├── specs/
│ ├── README.md
│ └── aem-assets.openapi.yaml
├── docs/
│ └── aem-assets.api.md
└── AGENTS.md
Actualisation des spécifications
Lorsqu’Adobe publie une nouvelle version d’API : téléchargez un nouvel instantané dans /specs, mettez à jour la date dans README.md, puis régénérez l’index et le AGENTS.md.
Les API en action
Les API offrent aux équipes de développement un contrôle programmatique complet pour créer des applications ciblées qui automatisent des workflows CX Enterprise spécifiques. Ces procédures pas à pas présentent des intégrations réelles créées de bout en bout, de la configuration des informations d’identification au code de travail que votre entreprise peut envoyer.
Appeler des API AEM à partir d’une application web
Créez une application web qui authentifie les utilisateurs et appelle les OpenAPI d’AEM à l’aide d’OAuth pour fournir un accès gouverné et programmatique.