ビルダー用API
Adobe CX Enterprise APIでは、開発者とAIを活用したコーディングエージェンティックツールが、Adobeのデータとワークフローに直接アクセスできます。 カスタムアプリケーションの構築や統合の自動化、Adobeの機能の自社システムへの組み込みに利用できます。 APIは、システム統合を完全にプログラム制御する必要がある場合や、Adobeデータを基にアプリケーションを構築する場合に最適な選択肢です。 Adobe ワークフローへのエージェント駆動型の会話型アクセスについては、MCP サーバーを参照してください。
Adobe CX Enterprise API
レポート、データフィード、計算指標、セグメント管理。
カタログ、カート、注文、顧客、プロモーション用のRESTおよびGraphQL API。
データセット、スキーマ、プロファイル、ID、クエリ、セグメント化のCRUD操作。
ジャーニーのオーケストレーション、キャンペーン管理、コンテンツテンプレート、オファーの決定。
Adobe Experience Managerのコンテンツ、アセット、ワークフロー管理API。
オーディエンスの管理とアクティベーションのワークフロー。
モバイル SDK、エッジ SDK、アプリ内メッセージ。
Adobe Analyticsのデータアクセス、レポート、CJAのインサイトのワークフロー。
Edge Networkデータの収集、リアルタイムのイベント収集、ストリーミングデータの配信。
API プロジェクトの設定、認証、資格情報管理。
イベント駆動型の統合、webhook、自動化トリガー:
プライバシーワークフロー、データガバナンス、データ主体のリクエスト：
ユーザー管理、ID管理、エンタープライズアカウントの自動化。
APIを使用した構築
Claude Code、Cursor、OpenAI Codexなどのコーディングエージェントは、Adobe CX Enterprise APIを使用した構築に適しています。 プロジェクトにOpenAPI仕様を追加すると、エージェントは手動での配線なしでエンドポイントを発見し、リクエストを作成し、API動作の理由を確認できます。 まず、Adobe Developer Consoleの認証済み資格情報と、プロジェクトに追加されたAPI ドキュメントの2つが必要です。
Adobe Developer ConsoleでのAPI資格情報の設定
すべてのAdobe CX Enterprise API アクセスはAdobe Developer Consoleを通じて管理されます。 プロジェクトを作成し、アプリケーションに必要なAPIを追加し、資格情報を生成します。
- ログインしてAdobe Developer Consoleでプロジェクト を作成します。
- 必要なAdobe CX Enterprise アプリケーションのAPIを追加します。
- 認証タイプ を選択してください。 自動ワークフローには OAuth サーバー間 を使用し、ユーザー向けアプリケーションには OAuth Web App を使用します。
- 認証情報を生成。 アプリケーションで使用するクライアント ID、クライアント秘密鍵、およびトークンエンドポイントをメモします。
ほとんどのAdobe CX Enterprise APIには、アプリケーションのライセンスが必要です。 Developer Console プロジェクトでAPIが使用できない場合は、Adobe担当者にお問い合わせください。
プロジェクトにAdobe API コンテキストを追加する
AI コーディングエージェントは、プロジェクトに適切な参照資料を追加すると、Adobe APIを確実に検出して使用できます。 これは、OpenAPI仕様を公開するあらゆるAdobe CX Enterprise APIで機能します。
1. API仕様を検索
上記のAdobe CX Enterprise APIを参照するか、Adobe Developer API カタログ に直接移動します。
2. OpenAPI仕様をダウンロード
プロジェクトに/specs ディレクトリを作成します。 developer.adobe.comのAPI参照ページからOpenAPI YAMLをダウンロードし、そこに保存します。 ソース URLとダウンロード日を記録するREADME.mdを追加します。
/specs/README.md
/specs/aem-assets.openapi.yaml
3. API インデックスを生成
このプロンプトをコーディングエージェントに貼り付け、<API-SPEC-FILE>をファイル名に置き換えます。
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. エージェントの指示を生成
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.を確認
生成されたファイルのみを使用して、コーディング担当者に簡単なタスクを完了するように依頼します。
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.
エージェントが動作を発明せずに正しく完了した場合、設定は完了します。
推奨されるプロジェクト構造
project/
├── specs/
│ ├── README.md
│ └── aem-assets.openapi.yaml
├── docs/
│ └── aem-assets.api.md
└── AGENTS.md
スペックを最新の状態に保つ
Adobeが新しいAPI バージョンを公開する場合：新しいスナップショットを/specsにダウンロードし、README.mdで日付を更新し、インデックスとAGENTS.mdを再生成します。
APIの活用例
開発チームは、APIを通じて完全なプログラマティック制御を実現し、特定の顧客体験向けエンタープライズワークフローを自動化するアプリケーションを構築できます。 これらのウォークスルーでは、資格情報の設定から組織が出荷できる作業コードまで、エンドツーエンドで構築された実際の統合を示しています。
OAuthを使用してユーザーを認証し、AEM OpenAPIを呼び出して、管理されたプログラマティックなアクセスを提供するweb アプリケーションを構築します。