Skip to main content
Join the Agentforce Hackathon on Nov. 18-19 to compete for a $20,000 Grand Prize. Sign up now. Terms apply.

Configurar e conectar o Postman

Nota

Nota

Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e use as traduções fornecidas entre parênteses para navegar. Copie e cole somente os valores em inglês porque as validações dos desafios dependem de dados em inglês. Se você não passar no desafio em sua organização de português (Brasil), recomendamos que (1) mude o local para os Estados Unidos, (2) mude o idioma para inglês, seguindo as instruções aqui, e (3) clique novamente no botão “Validar o desafio”.

Consulte o emblema Trailhead no seu idioma para saber mais sobre como aproveitar a experiência de Trailhead em outros idiomas.

Inscrever-se no Postman e criar um workspace

O Postman tem duas opções para funcionar com o aplicativo: desktop e web. Você usará o aplicativo do navegador da web neste projeto.

  1. Entre na sua conta do Postman ou inscreva-se em uma conta.
  2. Selecione o menu Workspaces.
  3. Selecione Create Workspace (Criar workspace).
  4. Dê ao workspace o nome de SalesforceCollection.
  5. Defina Visibility (Visibilidade) como Personal (Pessoal).
  6. Clique em Create Workspace (Criar workspace).

Bifurcar a coleção do Salesforce

  1. Abra a workspace público Salesforce Developers (Desenvolvedores do Salesforce) para bifurcar a coleção de APIs do Salesforce.
  2. Em Collections (Coleções), selecione Salesforce Platform APIs (APIs da Salesforce Platform) para expandir a opção.
  3. Clique em Bifurcar para bifurcar a coleção.
  4. Digite MySalesforceAPIFork.
  5. Mantenha SalesforceCollection como workspace.
  6. Clique em Fork Collection (Bifurcar coleção).

Agora você tem a coleção pronta no Postman. Vamos usar a coleção para autorizar sua organização e testá-la.

Autorizar sua organização

Você precisa se autenticar com o Salesforce para acessar as APIs. A autenticação concede a você um token de acesso válido por determinado tempo. Repita esse processo sempre que seu token de acesso expirar.

  1. Faça login somente em um Trailhead Playground no seu navegador.
  2. No Postman, em Collections (Coleções), a opção Salesforce Platform APIs (APIs da Salesforce Platform) deve estar selecionada.
  3. Verifique se No Environment (Sem ambiente) está selecionado.
  4. A guia Authorization (Autorização) deve estar aberta.
  5. O tipo deve ser OAuth 2.0.
  6. Clique em Get New Access Token (Obter novo token de acesso).
Nota

Se você não estiver conectado a um Trailhead Playground ou a uma organização do Salesforce, uma guia do navegador será aberta com a tela de login do Salesforce. Insira o nome de usuário e a senha salva na etapa 1 para fazer login.

  1. Clique em Allow (Permitir) para deixar a “Salesforce Platform APIs Collection for Postman” (Coleção de APIs da Salesforce Platform para Postman) acessar seu Trailhead Playground.
    No diálogo Allow Access? (Permitir acesso?), clique em Allow (Permitir) para que a Coleção de APIs do Salesforce para Postman possa acessar suas informações básicas e acessar e gerenciar seus dados, ou clique em Deny (Recusar). Para revogar o acesso a qualquer hora, acesse suas configurações pessoais.
  2. Uma mensagem de sucesso aparece rapidamente e você é redirecionado para o diálogo Manage Access Tokens (Gerenciar tokens de acesso).
    A caixa Manage Access Tokens (Gerenciar tokens de acesso) mostra as opções de nome do token, token de acesso, tipo de token, instance_url, issued_at, assinatura e escopo
  3. Verifique se instance_url aponta para seu Trailhead Playground.
  4. Copie a instance_url para usar na etapa 12. Copie somente a URL, sem caracteres extras.
  5. Clique em Use Token (Usar token).
  6. Abra a guia Variables (Variáveis).
  7. Na linha _endpoint, coluna CURRENT VALUE (VALOR ATUAL), cole o valor de instance_url copiado na etapa 9.
  8. Clique em Save (Salvar).

Um teste de conexão rápido

Vamos verificar se a conexão está funcionando.

  1. Em Collections (Coleções), selecione Salesforce Platform APIs (APIs da Salesforce Platform) para expandir a opção.
  2. Selecione REST para expandi-lo.
  3. Selecione GET Limits.
    Limits abre no painel principal.
  4. Clique em Send (Enviar).
    Guia GET Limits do Postman com a resposta do corpo exibida no painel principal. Status aparece como 200 OK.
  5. Verifique se o status é 200 OK.
    Você pode precisar ATIVAR a configuração Follow Authorization header (Seguir cabeçalho de autorização) para preservar o cabeçalho de autorização quando houver um redirecionamento para um nome de host diferente.
    Configuração de seguimento de cabeçalho de autorização nas configurações de solicitação GET

Você se autenticou com êxito no Salesforce. Agora você pode usar outras solicitações na coleção.

Publicar uma conta

Você acabou de recuperar alguns dados da organização. Vamos tentar adicionar novos dados à organização.

  1. Em REST, selecione SObject e, em seguida, selecione POST SObject Criação.
  2. Abra a guia Params.
  3. Em Path Variables (Variáveis de caminho), na linha SOBJECT_API_NAME, coluna VALUE (VALOR), digite Account (Conta).
  4. Abra a guia Body (Corpo).
  5. Substitua o texto do corpo por este código:
    {
  "Name": "Postman",
  "BillingState": "CA"
}
  6. Clique em Save (Salvar).
  7. Clique em Send (Enviar).
    O Postman retorna a ID da nova conta.
    Postman com SObject Create exibido no painel principal mostrando os resultados de envio e corpo substituído. Status aparece como 201 Created.
  8. Verifique se o status é 201 Created.
Nota

Se você não receber o status 201 Created, talvez esteja conectado a uma organização diferente. Verifique se instance_url está definida com seu Trailhead Playground.

  1. Abra o Playground autorizado.
  2. No App Launcher (Iniciador de aplicativos) (“”), encontre e abra Accounts (Contas).
  3. Verifique se a nova conta está ali agora.

Excelente! Você configurou o Postman para interagir com sua organização. A coleção de APIs do Salesforce para Postman carregada vai ajudar você no processo de descoberta das APIs do Salesforce.

Recursos

Compartilhe seu feedback do Trailhead usando a Ajuda do Salesforce.

Queremos saber sobre sua experiência com o Trailhead. Agora você pode acessar o novo formulário de feedback, a qualquer momento, no site Ajuda do Salesforce.

Saiba mais Continue compartilhando feedback