Configurar o Postman para uso com o Amazon Pinpoint - Amazon Pinpoint

Aviso de fim do suporte: em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Depois de 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint ou os recursos do Amazon Pinpoint (endpoints, segmentos, campanhas, viagens e análises). Para obter mais informações, consulte Fim do suporte do Amazon Pinpoint. Observação: APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar o Postman para uso com o Amazon Pinpoint

Agora que você criou um usuário que pode acessar a API do Amazon Pinpoint, é possível configurar o Postman. Nesta seção, você cria um ou mais ambientes no Postman. Em seguida, importe uma coleção que contenha um modelo de solicitação para cada uma das operações na API do Amazon Pinpoint.

No Postman, um espaço de trabalho é um contêiner organizacional para projetos e ambientes. Nesta seção, você criará pelo menos um espaço de trabalho para usar com o Amazon Pinpoint.

Criar um espaço de trabalho

No Postman, vá até o campo de mais ações, escolha Arquivo e, depois, Novo.

  1. Na janela Criar novo, escolha Espaço de trabalho.

  2. Insira um nome, um resumo e defina a visibilidade como pessoal. Em seguida, escolha Criar espaço de trabalho.

No Postman, um ambiente é um conjunto de variáveis que são armazenadas como pares de chave-valor. Você pode usar ambientes para alterar a configuração das solicitações feitas por meio do Postman, sem precisar alterar as próprias solicitações da API.

Nesta seção, você criará pelo menos um ambiente para usar com o Amazon Pinpoint. Cada ambiente que você cria contém um conjunto de variáveis que são específicas para sua conta em uma única Região da AWS. Se você usar os procedimentos nesta seção para criar mais de um ambiente, poderá alternar facilmente entre Regiões, escolhendo um ambiente diferente no menu Ambiente no Postman.

Para criar um ambiente

  1. No Postman, vá até o menu de mais ações, escolha Arquivo e, depois, Novo.

  2. Na janela Create New (Criar novo), escolha Environment (Ambiente).

  3. Na janela MANAGE ENVIRONMENTS (GERENCIAR AMBIENTES), de Environment Name (Nome do ambiente), insira Amazon Pinpoint - Region Name. Region NameSubstitua por um dos seguintes valores:

    • Leste dos EUA (N. da Virgínia)

    • Oeste dos EUA (Oregon)

    • Ásia-Pacífico (Mumbai)

    • Ásia-Pacífico (Sydney)

    • Europa (Frankfurt)

    • Europa (Irlanda)

    nota

    No mínimo, você só precisa criar um ambiente para um único Região da AWS, que Região da AWS deve conter um projeto. Se você não criou um projeto em um dos listados anteriormente Regiões da AWS, consulte Criação de um projeto do Amazon Pinpoint com suporte por e-mail no Guia do usuário do Amazon Pinpoint.

  4. Crie seis novas variáveis: endpoint, region, serviceName, accountId, accessKey e secretAccessKey. Use a tabela a seguir para determinar qual valor inserir nas colunas Valor inicial e Valor atual para cada variável.

    Região Variável Valor inicial e atual
    Leste dos EUA (Norte da Virgínia) endpoint pinpoint.us-east-1.amazonaws.com
    region us-east-1
    serviceName mobiletargeting
    accountId (ID AWS da sua conta)
    accessKey (seu ID de chave de acesso do IAM)
    secretAccessKey (sua chave de acesso secreta do IAM)
    Oeste dos EUA (Oregon) endpoint pinpoint.us-west-2.amazonaws.com
    region us-west-2
    serviceName mobiletargeting
    accountId (ID AWS da sua conta)
    accessKey (seu ID de chave de acesso do IAM)
    secretAccessKey (sua chave de acesso secreta do IAM)
    Ásia-Pacífico (Mumbai) endpoint pinpoint.ap-south-1.amazonaws.com
    region ap-south-1
    serviceName mobiletargeting
    accountId (ID AWS da sua conta)
    accessKey (seu ID de chave de acesso do IAM)
    secretAccessKey (sua chave de acesso secreta do IAM)
    Ásia-Pacífico (Sydney) endpoint pinpoint.ap-southeast-2.amazonaws.com
    region ap-southeast-2
    serviceName mobiletargeting
    accountId (ID AWS da sua conta)
    accessKey (seu ID de chave de acesso do IAM)
    secretAccessKey (sua chave de acesso secreta do IAM)
    Europa (Frankfurt) endpoint pinpoint.eu-central-1.amazonaws.com
    region eu-central-1
    serviceName mobiletargeting
    accountId (ID AWS da sua conta)
    accessKey (seu ID de chave de acesso do IAM)
    secretAccessKey (sua chave de acesso secreta do IAM)
    Europa (Irlanda) endpoint pinpoint.eu-west-1.amazonaws.com
    region eu-west-1
    serviceName mobiletargeting
    accountId (ID AWS da sua conta)
    accessKey (seu ID de chave de acesso do IAM)
    secretAccessKey (sua chave de acesso secreta do IAM)

    Depois de criar essas variáveis, a janela MANAGE ENVIRONMENTS (GERENCIAR AMBIENTES) é semelhante ao exemplo mostrado na imagem a seguir.

    A janela Gerenciar Ambientes no Postman. A captura de tela mostra um ambiente chamado "US East (N. Virginia)" (Leste dos EUA (Norte da Virgínia]). O ambiente contém as seguintes variáveis: Uma variável chamada “endpoint” e um valor inicial de”pinpoint.us-east-1.amazonaws.com". Uma variável denominada "região” e um valor inicial de "us-east-1". Uma variável denominada "serviceName" e um valor inicial de "mobiletargeting". Uma variável chamada “accountId” e um valor inicial de 123456789012 (um ID de conta fictício). AWS Uma variável chamada “accessKey” e um valor inicial de AKIAIOSFODNN7EXAMPLE (um ID de chave de acesso fictício). Uma variável chamada "secretAccessKey" e um valor inicial de wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY (uma chave de acesso secreta fictícia).

    Ao concluir, escolha Salvar.

    Importante

    As chaves de acesso mostradas na imagem anterior são fictícias. Não compartilhe suas chaves de acesso do IAM com outras pessoas.

    O Postman inclui recursos que permitem compartilhar e exportar ambientes. Se você usar esses recursos, tenha o cuidado de não compartilhar seu ID de chave de acesso e chave de acesso secreta com ninguém que não tenha acesso a essas credenciais.

    Para obter mais informações, consulte Práticas recomendadas do IAM no Guia do usuário do IAM.

  5. (Opcional) Repita as etapas de 1 a 4 para cada ambiente adicional que você deseja criar.

    dica

    No Postman, você pode criar quantos ambientes forem necessários. Você pode usar ambientes das seguintes maneiras:

    • Crie um ambiente separado para cada Região onde você precisa testar a API do Amazon Pinpoint.

    • Crie ambientes associados a diferentes Contas da AWS.

    • Crie ambientes que usam credenciais associadas a outro usuário.

  6. Ao terminar de criar ambientes, vá para a próxima seção.

No Postman, uma coleção é um grupo de solicitações de API. Solicitações em uma coleção geralmente são unidas por um propósito comum. Nesta seção, você criará uma coleção que contém um modelo de solicitação para cada operação na API do Amazon Pinpoint.

Como criar a coleção do Amazon Pinpoint

  1. No Postman, vá até o menu de mais ações, escolha Arquivo e, depois, Importar.

  2. Na janela Importar, escolha Importar do link e, em seguida, insira o seguinte URL: https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon %20Pinpoint.postman_collection.json.

    Escolha Importar. O Postman importa a coleção do Amazon Pinpoint, que contém 120 solicitações de exemplo.

Depois de importar a coleção do Amazon Pinpoint, recomenda-se um teste rápido para garantir que todos os componentes estejam configurados corretamente. Você pode testar sua configuração enviando uma solicitação GetApps. Essa solicitação retorna uma lista de todos os projetos existentes na sua conta do Amazon Pinpoint na Região da AWS atual. Como essa solicitação não exige nenhuma configuração adicional, trata-se de uma boa maneira de testar a configuração.

Como testar a configuração da coleção do Amazon Pinpoint

  1. No painel de navegação à esquerda, selecione Coleções, expanda a coleção do Amazon Pinpoint e expanda a pasta Aplicativos.

  2. Na lista de solicitações, escolha GetApps.

  3. Use o seletor Ambiente para escolher o ambiente que você criou em Criar ambientes do Postman.

  4. Selecione Enviar. Se a solicitação for enviada com sucesso, o painel de resposta mostrará um status de 200 OK. Você verá uma resposta que é semelhante ao exemplo na imagem a seguir.

    Um exemplo de resposta mostrando valores para Name, Id, Arn e Tags.
    nota

    Se você não tiver nenhum projeto criado no Região da AWS , o Amazon Pinpoint retornará. { "Item": [] }

    Essa resposta mostra uma lista de todos os projetos do Amazon Pinpoint que existem na sua conta na Região escolhida na etapa 3.

Solução de problemas

Ao enviar sua solicitação, talvez você veja um erro. Consulte a lista a seguir para ver vários erros comuns que você pode encontrar e as etapas que você pode seguir para resolvê-los.

Mensagem de erro Problema Resolução

Could not get any response

There was an error connecting to https://%7B%7Bendpoint%7D%7D/v1/apps.

Não há um valor atual para a variável {{endpoint}}, que é definida quando você escolhe um ambiente.

Use o seletor de ambiente para escolher um ambiente.

O token de segurança incluído na solicitação é inválido.

O Postman não conseguiu encontrar o valor atual de seu ID de chave de acesso ou chave de acesso secreta.

Escolha o ícone de engrenagem perto do seletor de ambiente e escolha o ambiente atual. Certifique-se de que os valores accessKey e secretAccessKey apareçam nas colunas VALOR INICIAL e VALOR ATUAL e que você tenha inserido as credenciais corretamente.

“Mensagem”: “Usuário: arn:aws:iam: :123456789012:user/ não está autorizado a realizar: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012PinpointPostmanUser: *” GetApps

A política do IAM associada ao seu usuário não incluem as permissões apropriadas.

Certifique-se de que seu usuário tenha as permissões descritas em Criar uma política do IAM e que você forneceu as credenciais corretas ao criar o ambiente em Criar um espaço de trabalho do Postman.

Próximo: Enviar solicitações adicionais