Postman no Adobe Experience Platform
O Postman é uma plataforma de colaboração para o desenvolvimento de API que permite configurar ambientes com variáveis predefinidas, compartilhar coleções de API, simplificar solicitações CRUD e muito mais. A maioria dos serviços de API da Platform tem coleções do Postman que podem ser usadas para ajudar a fazer chamadas de API.
Como configurar um ambiente do Postman para o Experience Platform
O guia de vídeo a seguir descreve a criação e a configuração do ambiente do Postman. Um ambiente do 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 um ACCESS_TOKEN
), você poderá atualizar o valor atual no ambiente e esse novo valor será usado em todas as coleções.
coleções do Postman collections
Uma pasta contendo todas as coleções disponíveis do Postman pode ser encontrada em, visitando o repositório GitHub de amostras do Experience Platform Postman. Como alternativa, um link de coleção do Postman pode ser encontrado em cada arquivo do Swagger individual na documentação de referência da API no Adobe I/O.
Para baixar uma coleção do Postman, selecione Raw na página do 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.
Importar uma coleção do Postman import
Para utilizar uma coleção do Postman, é necessário ter um ambiente configurado. Depois de concluir a configuração do ambiente, selecione o seletor Manage Environments no canto superior direito.
Um popover é exibido e exibe todos os seus ambientes atuais. Para importar uma coleção, selecione import .
Você será solicitado a escolher um arquivo para importar. Selecione o arquivo de coleção do Postman que deseja importar. Depois de selecionada, a coleção é preenchida no painel à esquerda na guia Coleções.
Cada coleção tem pares de chave-valor 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, as dicas e os exemplos necessários.
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 de não produção
O vídeo abaixo usa a coleção do Postman do Identity Management Service (IMS) que pode ser baixada do repositório público do GitHub.
Próximas etapas
Esse documento apresentou ambientes do Postman, coleções e como importar coleções. Agora que você tem o Postman pronto, visite o guia de introdução da Platform para obter informações sobre cabeçalhos, exemplos e uma lista de guias de API necessários disponíveis para cada serviço da Platform.