Postman no Adobe Experience Platform

O Postman é uma plataforma de colaboração para desenvolvimento de API que permite configurar ambientes com variáveis predefinidas, compartilhar coleções de API, simplificar solicitações de CRUD e muito mais. A maioria dos serviços de API da Platform tem coleções Postman que podem ser usadas para ajudar a fazer chamadas de API.

Como configurar um ambiente Postman para o Experience Platform

O guia de vídeo a seguir descreve a criação e a configuração do ambiente Postman. Um ambiente Postman contém todos os cabeçalhos necessários para fazer chamadas de API para as várias coleções fornecidas abaixo. Depois de configurado, sempre que um valor expirar (como ACCESS_TOKEN), você poderá atualizar o valor atual no ambiente e esse novo valor será usado em todas as suas coleções.

Coleções de carteiro

Uma pasta contendo todas as coleções disponíveis do Postman pode ser encontrada ao visitar o Experience Platform Postman samples do repositório GitHub. Como alternativa, um link de coleção do Postman pode ser encontrado em cada arquivo swagger individual na API reference documentation no Adobe I/O.

Para baixar uma coleção Postman, selecione Raw na página GitHub para carregar o arquivo JSON bruto em uma nova guia. Em seguida, clique com o botão direito do mouse e selecione Save as para salvar o arquivo em um destino local de sua escolha.

JSON bruto

Importar uma coleção Postman

Para utilizar uma coleção Postman, é necessário ter um ambiente configurado. Depois de concluir a configuração do ambiente, selecione o seletor Manage Environments no canto superior direito.

gerenciar seletor de ambiente

Um fornecedor é exibido e exibe todos os seus ambientes atuais. Para importar uma coleção, selecione import .

botão importar

Você deve escolher um arquivo para importar. Selecione o arquivo de coleção Postman que deseja importar. Depois de selecionada, a coleção é preenchida no painel à esquerda, na guia Collections .

coleção preenchida

Cada coleção tem pares de valores chave diferentes que podem ser necessários para executar uma operação CRUD bem-sucedida. Revise o Guia do desenvolvedor de API do serviço para saber mais sobre os valores necessários, dicas e ver exemplos.

Para saber mais sobre a interface do usuário do Postman e seus recursos disponíveis, visite a documentação do Postman.

Gerar um token de acesso com o Postman para uso não relacionado à produção

AVISO

Conforme observado na coleção Postman de geração de token de acesso ao Adobe I/O, os métodos de geração indicados são adequados para uso não relacionado à produção. A assinatura local carrega uma biblioteca do JavaScript de um host de terceiros e a assinatura remota envia a chave privada para um serviço da Web que é de propriedade e operado pelo Adobe. Embora o Adobe não armazene essa chave privada, as chaves de produção nunca devem ser compartilhadas com ninguém.

O vídeo abaixo usa a coleção Adobe I/O access token generation que pode ser baixada do repositório GitHub público.

Próximas etapas

Este documento apresentou ambientes Postman, coleções e como importar coleções. Agora que o Postman está pronto, visite o Guia de introdução à plataforma para obter informações sobre cabeçalhos, exemplos necessários e uma lista de guias de API disponíveis para cada serviço da plataforma.

Nesta página