Introdução ao Content and Commerce AI

OBSERVAÇÃO

A API do conteúdo e do comércio está em beta. A documentação está sujeita a alterações.

Content and Commerce AI O usa APIs do Adobe I/O. Para fazer chamadas para APIs do Adobe I/O e a Integração do console de E/S, primeiro complete o tutorial de autenticação.

No entanto, quando você chega à etapa Adicionar API , a API é localizada no Experience Cloud em vez do Adobe Experience Platform, como mostrado na seguinte captura de tela:

adição de Content e Commerce AI

A conclusão do tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todas as chamadas de API do Adobe I/O, conforme mostrado abaixo:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Criar um ambiente Postman (opcional)

Depois de configurar seu projeto e a API no Console do desenvolvedor do Adobe, você tem a opção de baixar um arquivo de ambiente para o Postman. Em APIs no painel esquerdo do seu projeto, selecione Content and Commerce AI. Uma nova guia é aberta, contendo um cartão rotulado "Try it out". Selecione Download for Postman para baixar um arquivo JSON usado para configurar seu ambiente postman.

download para postman

Após baixar o arquivo, abra o Postman e selecione o ícone de engrenagem na parte superior direita para abrir a caixa de diálogo gerenciar ambientes.

ícone de engrenagem

Em seguida, selecione Importar de dentro da caixa de diálogo Gerenciar ambientes.

importar

Você é redirecionado e é solicitado a selecionar um arquivo de ambiente do seu computador. Selecione o arquivo JSON que você baixou anteriormente e selecione Open para carregar o ambiente.

Você é redirecionado de volta à guia Gerenciar ambientes com um novo nome de ambiente preenchido. Selecione o nome do ambiente para exibir e editar as variáveis disponíveis no Postman. Ainda é necessário preencher manualmente os JWT_TOKEN e ACCESS_TOKEN. Esses valores devem ter sido obtidos ao concluir o tutorial de autenticação.

Uma vez concluída, suas variáveis devem ser semelhantes à captura de tela abaixo. Selecione Atualizar para concluir a configuração do seu ambiente.

Agora é possível selecionar seu ambiente no menu suspenso no canto superior direito e preencher automaticamente os valores salvos. Basta reeditar os valores a qualquer momento para atualizar todas as chamadas de API.

exemplo

Para obter mais informações sobre como trabalhar com APIs do Adobe I/O usando Postman, consulte a publicação Média em usando Postman para autenticação JWT em Adobe I/O.

Lendo exemplos de chamadas de API

Este guia fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações do . Isso inclui caminhos, cabeçalhos necessários e cargas de solicitação formatadas corretamente. O JSON de exemplo retornado nas respostas da API também é fornecido. Para obter informações sobre as convenções usadas na documentação para chamadas de API de exemplo, consulte a seção sobre como ler chamadas de API de exemplo no guia de solução de problemas do Experience Platform.

Próximas etapas

Depois de ter todas as suas credenciais, você estará pronto para configurar um trabalhador personalizado para Content and Commerce AI. Os documentos a seguir ajudam a compreender a estrutura de extensibilidade e a configuração do ambiente.

Para saber mais sobre a Estrutura de extensibilidade, comece lendo o documento introdução à extensibilidade. Este documento descreve os pré-requisitos e os requisitos de provisionamento.

Para saber mais sobre como configurar um ambiente para Content and Commerce AI, comece lendo o guia para configurar um ambiente de desenvolvedor. Este documento fornece instruções de configuração que permitem desenvolver o serviço do Asset compute.

Nesta página