Esta página descreve como autenticar e começar a usar o Adobe Experience Platform Destination SDK. Ele inclui instruções sobre como obter credenciais de autenticação do Adobe I/O, um nome de sandbox e a permissão de controle de acesso de criação de destino.
Este guia usa conceitos específicos da plataforma, como Organização IMS e sandboxes. Consulte o Glossário de Experience Platform para as definições destes e outros termos.
O Destination SDK usa a variável Adobe I/O gateway para autenticação. Para fazer chamadas de API para endpoints do Destination SDK, você deve fornecer determinados cabeçalhos em suas chamadas de API. Trabalhe com a equipe do Adobe Exchange para configurar a autenticação para você no Console do desenvolvedor do Adobe.
Para fazer chamadas com êxito para endpoints da API do Destination SDK, siga as Tutorial de autenticação de Experience Platform. Inicie o tutorial a partir do "Gerar uma chave de API, ID de organização IMS e segredo do cliente". A equipe do Adobe Exchange lidará com as etapas anteriores para você. A conclusão do tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em chamadas de API do Destination SDK, conforme mostrado abaixo:
x-api-key: {API_KEY}
também chamada de ID do clientex-gw-ims-org-id: {ORG_ID}
também conhecida como ID da organizaçãoAuthorization: Bearer {ACCESS_TOKEN}
. O token de acesso tem um tempo de expiração de 24 horas, expresso em milissegundos, portanto, será necessário atualizá-lo. Para atualizar o token de acesso, repita as etapas descritas no tutorial de autenticação.Todos os recursos no Experience Platform são isolados para sandboxes virtuais específicas. As solicitações para Destination SDK exigem cabeçalhos que especificam o nome da sandbox em que a operação ocorre:
x-sandbox-name: {SANDBOX_NAME}
A equipe do Adobe Exchange fornece o nome da sandbox, que deve ser usado em chamadas para os pontos de extremidade da API do Destination SDK.
Para usar os endpoints da API do Destination SDK descritos na documentação de referência, você precisa do Criação de destinos permissão de controle de acesso. Trabalhe com a equipe do Adobe Exchange para obter essa permissão atribuída a você em Adobe Admin Console.
Para obter mais informações, leia os seguintes documentos de Controle de Acesso ao Experience Platform:
Seguindo as etapas deste artigo, você obteve credenciais de autenticação para o Adobe I/O, um nome de sandbox e a permissão de controle de acesso de criação de destino. Em seguida, você pode configurar um destino usando o Destination SDK.
Leia os seguintes guias de configuração, dependendo do tipo de destino:
Para todas as operações, consulte a Documentação da API de criação de destino.
Use o Coleção Postman da API de criação de destino para configurar seu destino usando os endpoints da API do Destination SDK. Para começar a usar o Postman, consulte o etapas para importar ambientes e coleções e guia de vídeo para criar o ambiente Postman.