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 do 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 um ACCESS_TOKEN) é possível atualizar o valor atual no ambiente e esse novo valor é 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 acessar 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 de swagger individual na variável Documentação de referência da API na Adobe I/O.

Para baixar uma coleção do 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 do Postman

Para utilizar um Coleção Postman, é necessário ter um ambiente configurado. Depois de concluir a configuração do ambiente, selecione o 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 do 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 os Guia do desenvolvedor de API para saber mais sobre os valores obrigatórios, dicas e ver exemplos.

Para saber mais sobre a interface do usuário do Postman e seus recursos disponíveis, visite o 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 da 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 variável Coleção de geração de token de acesso ao Adobe I/O que podem ser baixadas do repositório público do GitHub.

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 obrigatórios, exemplos e uma lista de Guias da API disponível para cada serviço da plataforma.

Nesta página