APIs para construtores
As APIs corporativas do Adobe CX fornecem aos desenvolvedores e às ferramentas de agente de codificação assistida por IA acesso direto aos dados e fluxos de trabalho do Adobe. Use-os para criar aplicativos personalizados, automatizar integrações e incorporar recursos do Adobe em seus próprios sistemas. As APIs são a escolha certa quando você precisa de controle programático total sobre uma integração de sistema ou quando está criando um aplicativo com base nos dados do Adobe. Para acesso conversacional orientado por agente a fluxos de trabalho do Adobe, consulte servidores MCP.
APIs corporativas do Adobe CX
Relatórios, feeds de dados, métricas calculadas e gerenciamento de segmentos.
APIs REST e GraphQL para catálogo, carrinho, pedidos, clientes e promoções.
Operações CRUD para conjuntos de dados, esquemas, perfis, identidades, consultas e segmentação.
Orquestração de jornadas, gestão de campanhas, modelos de conteúdo e offer decisioning.
APIs de gerenciamento de conteúdo, ativos e fluxo de trabalho para o Adobe Experience Manager.
Gerenciamento de público-alvo e fluxos de trabalho de ativação.
SDKs móveis, SDKs de borda e mensagens no aplicativo.
Workflows de acesso a dados, relatórios e insights do CJA no Analytics.
Assimilação de dados do Edge Network, coleção de eventos em tempo real e entrega de dados de transmissão.
Configuração do projeto da API, autenticação e gerenciamento de credenciais.
Integrações orientadas por eventos, webhooks e acionadores de automação.
Workflows de privacidade, governança de dados e solicitações de titulares de dados.
Gerenciamento de usuários, administração de identidades e automação de contas corporativas.
Criar com APIs
Agentes de codificação como Claude Code, Cursor e OpenAI Codex são adequados para criação com APIs corporativas do Adobe CX. Adicione uma especificação OpenAPI ao seu projeto e o agente pode descobrir pontos de extremidade, criar solicitações e o motivo do comportamento da API sem fiação manual. Para iniciar, você precisa de duas coisas: credenciais autenticadas do Adobe Developer Console e documentação da API adicionada ao seu projeto.
Configurar credenciais de API no Adobe Developer Console
Todo o acesso à API do Adobe CX Enterprise é gerenciado por meio do Adobe Developer Console. Crie um projeto, adicione as APIs de que seu aplicativo precisa e gere credenciais.
- Entre e crie um projeto no Adobe Developer Console.
- Adicione a API para o aplicativo Adobe CX Enterprise de que você precisa.
- Escolha um tipo de autenticação. Use o OAuth Server-to-Server para fluxos de trabalho automatizados ou o OAuth Web App para aplicativos voltados para o usuário.
- Gere suas credenciais. Observe a ID do cliente, o segredo do cliente e o endpoint do token para uso em seu aplicativo.
A maioria das APIs do Adobe CX Enterprise requer licenciamento de aplicativos. Se uma API não estiver disponível em seu projeto do Developer Console, entre em contato com o representante da Adobe.
Adicionar o contexto da API do Adobe ao seu projeto
Os agentes de codificação de IA podem descobrir e usar APIs do Adobe de maneira confiável quando você adiciona o material de referência correto ao seu projeto. Isso funciona para qualquer API corporativa do Adobe CX que publique uma especificação OpenAPI.
1. Localizar a especificação de API
Navegue pelas APIs do Adobe CX Enterprise listadas acima ou vá diretamente para o catálogo de APIs do Adobe Developer.
2. Baixe a especificação OpenAPI
Crie um diretório /specs em seu projeto. Baixe o OpenAPI YAML da página de referências de API em developer.adobe.com e salve-o lá. Adicione um README.md gravando a URL de origem e a data de download.
/specs/README.md
/specs/aem-assets.openapi.yaml
3. Gerar um índice de API
Cole esse prompt no seu agente de codificação, substituindo <API-SPEC-FILE> pelo seu nome de arquivo:
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. Gerar instruções do 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. Verificar
Peça ao seu agente de codificação para concluir uma tarefa simples usando apenas os arquivos gerados:
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 o agente concluí-lo corretamente sem inventar comportamento, a configuração está concluída.
Estrutura de projeto recomendada
project/
├── specs/
│ ├── README.md
│ └── aem-assets.openapi.yaml
├── docs/
│ └── aem-assets.api.md
└── AGENTS.md
Mantendo as especificações atualizadas
Quando o Adobe publicar uma nova versão da API: baixe um instantâneo novo no /specs, atualize a data em README.md, gere novamente o índice e AGENTS.md.
APIs em ação
As APIs oferecem às equipes de desenvolvimento controle programático total para criar aplicativos focados que automatizam fluxos de trabalho específicos do CX Enterprise. Essas apresentações mostram integrações reais criadas de ponta a ponta, desde a configuração de credenciais até o código de trabalho que sua organização pode enviar.
Invocar APIs do AEM a partir de um aplicativo Web
Crie um aplicativo web que autentique usuários e chame AEM OpenAPIs usando OAuth para fornecer acesso controlado e programático.