APIs für Builder
Adobe CX Enterprise-APIs bieten Entwicklern und Entwicklern von KI-unterstützten Codierungsagenten-Tools direkten Zugriff auf Adobe-Daten und -Workflows. Verwenden Sie sie, um benutzerdefinierte Programme zu erstellen, Integrationen zu automatisieren und Adobe-Funktionen in Ihre eigenen Systeme einzubetten. APIs sind die richtige Wahl, wenn Sie die vollständige programmgesteuerte Kontrolle über eine Systemintegration benötigen oder eine Anwendung auf Adobe-Daten aufbauen. Informationen zum agentengesteuerten, konversativen Zugriff auf Adobe-Workflows finden Sie unter MCP-Server.
Adobe CX Enterprise-APIs
Berichte, Daten-Feeds, berechnete Metriken und Segmentverwaltung.
REST- und GraphQL-APIs für Katalog, Warenkorb, Bestellungen, Kunden und Promotions.
CRUD-Vorgänge für Datensätze, Schemata, Profile, Identitäten, Abfragen und Segmentierung.
Journey-Orchestrierung, Kampagnenverwaltung, Inhaltsvorlagen und Offer Decisioning.
Inhalts-, Asset- und Workflow-Management-APIs für Adobe Experience Manager.
Zielgruppen-Management und Aktivierungs-Workflows.
Mobile SDKs, Edge SDKs und In-App-Messaging.
Workflows für Datenzugriff, Reporting und CJA Insights in Analytics.
Datenaufnahme, Echtzeit-Ereigniserfassung und Streaming-Datenbereitstellung in Edge Network.
Einrichtung, Authentifizierung und Verwaltung von API-Projekten.
Ereignisgesteuerte Integrationen, Webhooks und Automatisierungs-Trigger.
Datenschutz-Workflows, Data Governance und Anfragen von betroffenen Personen.
Benutzerverwaltung, Identitätsverwaltung und Automatisierung von Unternehmenskonten.
Erstellen mit APIs
Programmieragenten wie Claude Code, Cursor und OpenAI Codex eignen sich gut zum Erstellen mit Adobe CX Enterprise-APIs. Fügen Sie Ihrem Projekt eine OpenAPI-Spezifikation hinzu, und der Agent kann ohne manuelle Verdrahtung Endpunkte ermitteln, Anforderungen erstellen und Gründe für das API-Verhalten ermitteln. Zunächst benötigen Sie zwei Dinge: authentifizierte Anmeldeinformationen von Adobe Developer Console und API-Dokumentation, die zu Ihrem Projekt hinzugefügt werden.
Einrichten von API-Anmeldeinformationen in Adobe Developer Console
Der gesamte Zugriff auf die Adobe CX Enterprise API wird über Adobe Developer Console verwaltet. Erstellen Sie ein Projekt, fügen Sie die APIs hinzu, die Ihre Anwendung benötigt, und generieren Sie Anmeldeinformationen.
- Melden Sie sich an und erstellen Sie ein Projekt in Adobe Developer Console.
- API hinzufügen für die benötigte Adobe CX Enterprise-Anwendung.
- Wählen Sie einen Authentifizierungstyp. Verwenden Sie OAuth Server-zu-Server für automatisierte Workflows oder OAuth Web App für Anwendungen mit Benutzerzugriff.
- Erstellen Sie Ihre Anmeldedaten. Notieren Sie sich die Client-ID, den geheimen Client-Schlüssel und den Token-Endpunkt zur Verwendung in Ihrer Anwendung.
Die meisten Adobe CX Enterprise-APIs erfordern eine Anwendungslizenzierung. Wenn in Ihrem Developer Console-Projekt keine API verfügbar ist, wenden Sie sich an den Adobe-Support.
Hinzufügen von Adobe-API-Kontext zu Ihrem Projekt
KI-Codierer können Adobe-APIs zuverlässig erkennen und verwenden, wenn Sie das richtige Referenzmaterial zu Ihrem Projekt hinzufügen. Dies funktioniert für jede Adobe CX Enterprise-API, die eine OpenAPI-Spezifikation veröffentlicht.
1. Suchen Sie die API-Spezifikation
Durchsuchen Sie die oben aufgeführten Adobe CX EnterpriseAPIs oder navigieren Sie direkt zum Adobe Developer-API-Katalog.
2. Laden Sie die OpenAPI-Spezifikation herunter
Erstellen Sie ein /specs in Ihrem Projekt. Laden Sie OpenAPI YAML von der Seite mit den API-Referenzen auf developer.adobe.com herunter und speichern Sie es dort. Fügen Sie eine README.md hinzu, die die Quell-URL und das Download-Datum aufzeichnet.
/specs/README.md
/specs/aem-assets.openapi.yaml
3. API-Index generieren
Fügen Sie diese Eingabeaufforderung in Ihren Codierungsagenten ein und ersetzen Sie <API-SPEC-FILE> durch Ihren Dateinamen:
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. Generieren Sie Agentenanweisungen
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. Überprüfen
Bitten Sie den Codierer, eine einfache Aufgabe auszuführen, indem er nur die generierten Dateien verwendet:
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.
Wenn der Agent den Vorgang korrekt abschließt, ohne das Verhalten zu erfinden, ist die Einrichtung abgeschlossen.
Empfohlene Projektstruktur
project/
├── specs/
│ ├── README.md
│ └── aem-assets.openapi.yaml
├── docs/
│ └── aem-assets.api.md
└── AGENTS.md
Aktuelle Spezifikationen beibehalten
Wenn Adobe eine neue API-Version veröffentlicht: Laden Sie einen neuen Schnappschuss in /specs herunter, aktualisieren Sie das Datum in README.md und generieren Sie den Index und die AGENTS.md neu.
APIs in Aktion
APIs geben Entwicklungsteams die volle programmatische Kontrolle, um fokussierte Anwendungen zu erstellen, die bestimmte CX Enterprise-Workflows automatisieren. Diese exemplarischen Vorgehensweisen zeigen echte Integrationen, die von der Einrichtung von Anmeldeinformationen bis zum funktionierenden Code, den Ihr Unternehmen versenden kann, durchgängig erstellt wurden.
Aufrufen von AEM-APIs aus einer Web-Anwendung
Erstellen Sie eine Web-Anwendung, die Benutzende authentifiziert und AEM OpenAPIs mit OAuth aufruft, um einen gesteuerten, programmgesteuerten Zugriff bereitzustellen.