Configurar o Console do desenvolvedor e Postman
Nesta lição, você configurará um projeto no Console do Adobe Developer e baixará Postman coleções para que você possa começar a usar as APIs da Platform.
Para concluir os exercícios de API neste tutorial, baixe o aplicativo Postman para o seu sistema operacional. Embora não seja necessário para usar APIs de Experience Platform, o Postman facilita os fluxos de trabalho de API, e o Adobe Experience Platform fornece dezenas de coleções do Postman para ajudar você a executar chamadas de API e saber como elas operam. O restante deste tutorial presume algum conhecimento prático do Postman. Para obter ajuda, consulte o Documentação do Postman.
A Platform é criada como API. Embora as opções de interface também existam para todas as principais tarefas, você pode querer usar a API da plataforma em algum momento. Por exemplo, para assimilar dados, mover itens entre sandboxes, automatizar tarefas de rotina ou usar novos recursos da Platform antes que a interface do usuário tenha sido criada.
Arquitetos de dados e Engenheiros de dados pode precisar usar a API da plataforma fora deste tutorial.
Permissões necessárias
No Configurar permissões você configura todos os controles de acesso necessários para concluir esta lição.
Configurar o console do Adobe Developer
O Adobe Developer Console é o destino do desenvolvedor para acessar APIs e SDKs do Adobe, ouvir eventos quase em tempo real, executar funções no tempo de execução ou criar plug-ins ou aplicativos do App Builder. Você o usará para acessar a API Experience Platform. Para obter mais detalhes, consulte Documentação do console do Adobe Developer
-
Crie uma pasta no computador local chamada
Luma Tutorial Assets
para arquivos usados no tutorial. -
Abra o Console do Adobe Developer
-
Faça logon e confirme se você está na organização correta
-
Selecionar Criar novo projeto in Início rápido menu.
-
No projeto recém-criado, selecione a variável Editar Projeto botão
-
Altere o Título do projeto para
Luma Tutorial API Project
(adicione seu nome ao final se várias pessoas da sua empresa estiverem fazendo este tutorial) -
Selecione Salvar
-
Selecionar Adicionar API
-
Filtrar a lista selecionando Adobe Experience Platform
-
Na lista de APIs disponíveis, selecione API EXPERIENCE PLATFORM e selecione Próxima.
-
Selecionar Servidor OAuth para servidor como credencial e selecione Próxima.
-
Selecione o
AEP-Default-All-Users
perfil do produto e selecione Salvar API configurada -
Agora o projeto do Developer Console foi criado.
-
No Experimente da página, selecione Baixar para Postman e selecione Servidor OAuth para servidor para baixar o Postman arquivo json do ambiente. Salve o
oauth_server_to_server.postman_environment.json
no seuLuma Tutorial Assets
pasta.
Faça um administrador do sistema adicionar a credencial de API à função
Para usar a credencial de API para interagir com o Experience Platform, será necessário que um administrador do sistema atribua as credenciais de API à função criada na lição anterior. Caso você não seja um Administrador do sistema, envie-os:
-
A variável Nome da sua credencial de API (
Credential in Luma Tutorial API Project
) -
A variável Email da conta técnica da sua credencial (isso ajudará o Administrador do sistema a encontrar a credencial)
Estas são as instruções para o Administrador do sistema:
-
Efetue logon no Adobe Experience Platform
-
Selecionar Permissões na navegação à esquerda, que direcionará você para a Funções tela
-
Abra o
Luma Tutorial Platform
função
-
Selecione o Credenciais da API guia
-
Selecionar Adicionar credenciais de API
-
Localize o
Credential in Luma Tutorial API Project
credencial, filtragem com o Email da conta técnica fornecido pelo participante do tutorial, se a lista for longa -
Selecionar a credencial
-
Selecione Salvar
Configurar o Postman
-
Baixar e instalar Postman
-
Abertura Postman e criar um espaço de trabalho
-
Importe o arquivo de ambiente json baixado,
oauth_server_to_server.postman_environment.json
-
Entrada Postman, selecione seu ambiente na lista suspensa
-
Selecione o ícone para exibir as variáveis de ambiente:
Adicionar o nome da sandbox e a ID do locatário
A variável SANDBOX_NAME
e TENANT_ID
e CONTAINER_ID
As variáveis não são incluídas na exportação do console do Adobe Developer, portanto, as adicionamos manualmente:
-
Entrada Postman, abra o Variáveis de ambiente
-
Selecione o Editar link à direita do nome do ambiente
-
No Adicionar novo campo de variável, insira
SANDBOX_NAME
-
Em ambos os campos de valor, informe
luma-tutorial
, o nome que demos à nossa sandbox na lição anterior. Se você usou um nome diferente para sua sandbox, por exemplo, luma-tutorial-ignatiusjreilly, certifique-se de usar esse valor. -
No Adicionar novo campo de variável, insira
TENANT_ID
-
Alterne para o navegador da Web e procure a ID do locatário da sua empresa acessando a interface do Experience Platform e extraindo a parte do URL após o sinal @. Por exemplo, minha id de locatário é
techmarketingdemos
mas o seu é diferente: -
Copie esse valor e retorne ao campo Postman Tela Gerenciar ambientes
-
Cole sua ID do locatário nos dois campos de valor
-
No Adicionar novo campo de variável, insira
CONTAINER_ID
-
Enter
global
em ambos os campos de valornote note NOTE CONTAINER_ID
é um campo cujo valor alteramos várias vezes durante o tutorial. Quandoglobal
for usada, a API interagirá com elementos fornecidos pelo Adobe na sua conta da Platform. Quandotenant
for usada, a API interagirá com seus próprios elementos personalizados. -
Selecione Salvar
Fazer chamadas de API
Recuperar um token de acesso
O Adobe fornece um conjunto avançado de Postman coleções para ajudar a explorar a API do Experience Platform. Essas coleções estão no GitHub de exemplos do Adobe Experience Platform Postman. Você deve marcar este repositório como você usará isso várias vezes neste tutorial e posteriormente ao implementar o Experience Platform para sua própria empresa.
A primeira coleção funciona com as APIs do Adobe Identity Management Service (IMS). É uma maneira conveniente de recuperar um token de acesso de dentro do Postman.
Para gerar o token de acesso:
-
Baixe o Coleção de APIs de serviço do Identity Management ao seu
Luma Tutorial Assets
pasta -
Importar a coleção para Postman
-
Selecionar a solicitação oAuth: solicitar token de acesso solicitar e selecionar Enviar
-
Você deve obter um
200 OK
resposta com um token de acesso na resposta -
O token de acesso deve ser armazenado automaticamente como o ACCESS_TOKEN variável de ambiente do Postman ambiente.
Interagir com uma API da plataforma
Agora vamos fazer uma chamada à API da plataforma para confirmar se configuramos tudo corretamente.
Abra o Experience Platform Postman coleções no GitHub. Há muitas coleções nesta página, para várias APIs da plataforma. Eu recomendo fortemente marcá-lo.
Agora, vamos fazer nossa primeira chamada de API:
- Baixe o Coleção de APIs do registro de esquema ao seu
Luma Tutorial Assets
pasta - Importar para Postman
- Abertura API do registro de esquemas > Esquemas > Listar esquemas
- Olhe para o Params e Cabeçalhos e observe como elas incluem algumas das variáveis de ambiente inseridas anteriormente.
- Observe que Cabeçalhos > Aceitar campo de valor está definida como
application/vnd.adobe.xed-id+json
. As APIs do Registro de esquema exigem uma dessas valores do cabeçalho Aceitar especificados que fornecem diferentes formatos na resposta. - Selecionar Enviar para fazer sua primeira chamada de API da plataforma!
Espero que você tenha tido sucesso 200 OK
resposta contendo uma lista dos esquemas XDM fornecidos pelo Adobe disponíveis em sua sandbox, como mostrado abaixo.
Se a chamada não tiver sido bem-sucedida, aguarde um pouco para depurar usando os detalhes de resposta de erro da chamada da API e revise as etapas acima. Se você ficar paralisado, solicite ajuda no Fórum da comunidade ou use o link no lado direito desta página para "Registrar um problema".
Com suas permissões da Platform, sandbox e Postman configurado, você está pronto para dados de modelo em esquemas!