Autenticar e acessar a API do Reator
Para usar a API do Reator para criar e gerenciar extensões de Tags, cada solicitação deve incluir os seguintes cabeçalhos de autenticação:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Este guia mostra como usar o Adobe Developer Console a fim de coletar os valores de cada um desses cabeçalhos para que você possa começar a fazer chamadas à API do reator.
Obter acesso de desenvolvedor à Adobe Experience Platform gain-developer-access
A fim de gerar valores de autenticação para a API do reator, você deve ter acesso de desenvolvedor à Experience Platform. Para obter acesso de desenvolvedor, siga as etapas iniciais no tutorial de autenticação da Experience Platform. Depois de concluir a etapa Obter acesso do usuário, retorne a este tutorial para gerar as credenciais específicas da API do Reator.
Gerar credenciais de acesso generate-access-credentials
Usando o Adobe Developer Console, você deve gerar as três credenciais de acesso descritas a seguir:
{ORG_ID}{API_KEY}{ACCESS_TOKEN}
A ID ({ORG_ID}) e a chave de API ({API_KEY}) da sua organização podem ser reutilizadas em chamadas de API futuras depois de terem sido geradas. No entanto, seu token de acesso ({ACCESS_TOKEN}) é temporário e deve ser gerado novamente a cada 24 horas.
As etapas de geração desses valores são descritas em detalhes abaixo.
Configuração única one-time-setup
Acesse o Adobe Developer Console e faça logon com seu Adobe ID. Depois, siga as etapas descritas no tutorial sobre como criar um projeto vazio na documentação do Developer Console.
Depois de criar um projeto, selecione Adicionar API na tela Visão geral do projeto.
A tela Adicionar uma API é exibida. Selecione APIs de Experience Platform Launch na lista de APIs disponíveis antes de selecionar Avançar.
Em seguida, selecione o tipo de autenticação para gerar tokens de acesso e acessar a API Experience Platform.
Clique em Avançar para continuar.
A próxima tela solicita que você selecione um ou mais perfis de produto para associar à integração com a API.
Selecione os perfis de produto desejados na lista e selecione Salvar API configurada para concluir o registro da API.
Coletar credenciais gather-credentials
Depois que a API for adicionada ao projeto, a página APIs de Experience Platform do projeto exibirá as seguintes credenciais, necessárias em todas as chamadas para APIs de Experience Platform:
{API_KEY}(ID do Cliente){ORG_ID}(ID da Organização)
Gerar um token de acesso generate-access-token
A próxima etapa é gerar uma credencial {ACCESS_TOKEN} para uso em chamadas de API da plataforma. Diferentemente dos valores de {API_KEY} e {ORG_ID}, um novo token deve ser gerado a cada 24 horas para continuar usando as APIs da plataforma.
Você tem duas opções para gerar os tokens de acesso, dependendo do caso de uso:
Gerar tokens de acesso manualmente manual
Para gerar manualmente um novo {ACCESS_TOKEN}, navegue até Credenciais > Servidor para servidor OAuth e selecione Gerar token de acesso, conforme mostrado abaixo.
É gerado um novo token de acesso, e é fornecido um botão para copiá-lo para a área de transferência. Este valor é usado para o cabeçalho de Autorização necessário e deve ser fornecido no formato Bearer {ACCESS_TOKEN}.
Geração de token automatizada auto-token
Você também pode usar um ambiente e uma coleção do Postman para gerar tokens de acesso. Para obter mais informações, leia a seção sobre como usar o Postman para autenticar e testar chamadas de API no guia de autenticação de API Experience Platform.
Credenciais da API de teste test-api-credentials
Seguindo as etapas deste tutorial, você deve ter valores válidos para {ORG_ID}, {API_KEY} e {ACCESS_TOKEN}. Agora é possível testar esses valores usando-os em uma solicitação de cURL simples para a API do Reactor.
Para começar, tente fazer uma chamada de API para listar todas as empresas.
Depois de confirmar que suas credenciais de acesso estão funcionando, continue explorando a outra documentação de referência da API para saber mais sobre os vários recursos da API.
Leitura de chamadas de API de amostra read-sample-api-calls
Cada manual de endpoint fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações. Isso inclui caminhos, cabeçalhos necessários e conteúdos de solicitação formatados corretamente. Também fornece exemplos de JSON retornado nas respostas da API. 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 introdução para APIs da plataforma.
Próximas etapas next-steps
Agora que você entende quais cabeçalhos usar, você está pronto para começar a fazer chamadas para a API do Reator. Selecione um dos manuais de endpoint para começar: