API per generatori
Le API Enterprise di Adobe CX consentono agli sviluppatori e agli strumenti di codifica basati sull’intelligenza artificiale di accedere direttamente ai dati e ai flussi di lavoro di Adobe. Utilizzale per creare applicazioni personalizzate, automatizzare le integrazioni e incorporare le funzionalità di Adobe nei tuoi sistemi. Le API sono la scelta giusta quando hai bisogno di un controllo programmatico completo sull’integrazione di un sistema o quando crei un’applicazione sopra i dati di Adobe. Per l’accesso conversazionale basato su agenti ai flussi di lavoro di Adobe, vedere Server MCP.
API di Adobe CX Enterprise
Reporting, feed di dati, metriche calcolate e gestione dei segmenti.
API REST e GraphQL per catalogo, carrello, ordini, clienti e promozioni.
Operazioni CRUD per set di dati, schemi, profili, identità, query e segmentazione.
Orchestrazione del percorso, gestione delle campagne, modelli di contenuto e Offer Decisioning.
API per la gestione di contenuti, risorse e flussi di lavoro per Adobe Experience Manager.
Flussi di lavoro di attivazione e gestione dell’audience.
SDK per dispositivi mobili, SDK edge e messaggistica in-app.
Flussi di lavoro per l’accesso ai dati di Analytics, la generazione di rapporti e approfondimenti su CJA.
Acquisizione dei dati di Edge Network, raccolta di eventi in tempo reale e distribuzione di dati in streaming.
Configurazione del progetto API, autenticazione e gestione delle credenziali.
Integrazioni guidate da eventi, webhook e trigger di automazione.
Flussi di lavoro per la privacy, governance dei dati e richieste degli interessati.
Gestione degli utenti, amministrazione delle identità e automazione degli account aziendali.
Creare con API
Gli agenti di codifica come Claude Code, Cursor e OpenAI Codex sono particolarmente adatti per la creazione di API aziendali di Adobe CX. Aggiungi una specifica OpenAPI al progetto affinché l’agente possa individuare endpoint, creare richieste e motivare il comportamento dell’API senza dover ricorrere a cablaggi manuali. Per iniziare, è necessario disporre di due elementi: credenziali autenticate provenienti da Adobe Developer Console e documentazione API aggiunta al progetto.
Configurare le credenziali API in Adobe Developer Console
Tutti gli accessi alle API di Adobe CX Enterprise sono gestiti tramite Adobe Developer Console. Crea un progetto, aggiungi le API necessarie per l’applicazione e genera le credenziali.
- Accedi e crea un progetto in Adobe Developer Console.
- Aggiungere l’API per l’applicazione Adobe CX Enterprise necessaria.
- Scegli un tipo di autenticazione 🔗. Utilizza OAuth Server-to-Server per flussi di lavoro automatizzati o OAuth Web App per applicazioni rivolte all’utente.
- Genera le credenziali. Prendi nota dell’ID client, del segreto client e dell’endpoint token da utilizzare nell’applicazione.
La maggior parte delle API Adobe CX Enterprise richiede licenze per le applicazioni. Se un’API non è disponibile nel progetto Developer Console, contatta il rappresentante Adobe.
Aggiungere al progetto il contesto API di Adobe
Gli agenti di codifica IA possono individuare e utilizzare in modo affidabile le API di Adobe quando aggiungi al progetto il materiale di riferimento corretto. Questo funziona per qualsiasi API aziendale di Adobe CX che pubblica una specifica OpenAPI.
1. Trova la specifica API
Sfoglia le API Adobe CX Enterprise elencate sopra o passa direttamente al catalogo API Adobe Developer.
2. Scarica la specifica OpenAPI
Crea una directory /specs nel progetto. Scarica il file YAML OpenAPI dalla pagina dei riferimenti API in developer.adobe.com e salvalo. Aggiungi un README.md per registrare l’URL di origine e la data di download.
/specs/README.md
/specs/aem-assets.openapi.yaml
3. Genera un indice API
Incolla questo prompt nell’agente di codifica, sostituendo <API-SPEC-FILE> con il tuo nome 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. Genera istruzioni agente
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. Verifica
Chiedi all’agente di codifica di completare un’attività semplice utilizzando solo i file generati:
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.
Se l’agente lo completa correttamente senza inventare il comportamento, l’impostazione è completa.
Struttura di progetto consigliata
project/
├── specs/
│ ├── README.md
│ └── aem-assets.openapi.yaml
├── docs/
│ └── aem-assets.api.md
└── AGENTS.md
Specifiche aggiornate
Quando Adobe pubblica una nuova versione API: scarica una nuova istantanea in /specs, aggiorna la data in README.md e rigenera l’indice e AGENTS.md.
API in azione
Le API offrono ai team di sviluppo un controllo programmatico completo per la creazione di applicazioni mirate che automatizzano flussi di lavoro aziendali CX specifici. In queste procedure dettagliate vengono illustrate le integrazioni effettive create in modo completo, dalla configurazione delle credenziali al codice di lavoro che può essere fornito dall’organizzazione.
Richiama API AEM da un'app Web
Crea un’applicazione web che autentica gli utenti e chiama le API aperte di AEM utilizzando OAuth per fornire un accesso regolamentato e programmatico.