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.

JSON bruto

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.

gerenciar seletor de ambiente

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

botão Importar

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.

coleção preenchida

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

WARNING
Conforme observado na coleção do Postman do Identity Management Service (IMS), os métodos de geração indicados são adequados para uso de não 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 pertence 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 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.

recommendation-more-help
5741548a-2e07-44b3-9157-9c181502d0c5