Configurar sua organização
Objetivos de aprendizagem
Neste projeto, você vai:
- Preparar sua organização para usar o Postman.
- Carregar a coleção APIs da Salesforce Platform para Postman.
- Conectar o Postman à sua organização.
- Verificar a conexão com o Postman.
Por que usar o Postman para acessar as APIs da Salesforce Platform?
O Salesforce expõe um conjunto avançado de interfaces de programa de aplicativo (APIs) que se integram a sistemas de terceiros. Todas essas APIs estão documentadas minuciosamente, mas como você pode experimentá-las rapidamente em uma organização, ou, melhor ainda, em várias? O Postman ajuda você a descobrir, explorar e testar opções de integração com as APIs da Salesforce Platform.
Sobre as APIs da Salesforce Platform
O Salesforce oferece acesso programático às informações da sua organização por meio de APIs simples, potentes e seguras. As APIs fornecidas pelo Salesforce incluem REST, SOAP, conexão, interface de usuário, análise, em massa, metadados e streaming.
Sobre o Postman
O Postman é um aplicativo que você pode usar para configurar e chamar APIs baseadas em HTTP, por exemplo, REST ou SOAP. Você pode configurar essa ferramenta poderosa em uma interface de usuário gráfica fácil de usar. Ela dá suporte a variáveis de ambiente, workspaces de equipe e automação de JavaScript. Se você é novo no Postman, confira seu Centro de aprendizagem.
Web ou desktop?
Use o Postman como aplicativo para desktop ou em um navegador da web. Neste projeto, você vai configurar e usar o Postman em um navegador da web porque isso não exige download e instalação de software.
Sobre a coleção de APIs da Salesforce Platform para Postman
Essa coleção é um recurso que encapsula mais de 200 modelos de solicitação para várias APIs da Salesforce Platform. Essa coleção de código aberto usa o ambiente e as variáveis configuráveis do Postman para você poder autenticar e experimentar essas solicitações facilmente em várias organizações do Salesforce.
Criar um novo Trailhead Playground
Para este projeto, é preciso criar um novo Trailhead Playground. Role até o final desta página, clique no nome do Playground e, em seguida, clique em Create Playground (Criar Playground). Normalmente, leva de 3 a 4 minutos para criar um novo Trailhead Playground.
Obter seu nome de usuário e senha do Trailhead Playground
Vamos começar abrindo seu Trailhead Playground. Role até o fim da página e clique em Iniciar. Se você vir uma guia na sua organização com o rótulo Obter suas credenciais de login, ótimo! Avance para a etapa 1. Caso contrário, no App Launcher (Iniciador de aplicativos) (), encontre e abra o Playground Starter e siga as etapas.
- Clique na guia Get Your Login Credentials (Obter suas credenciais de login) e anote seu nome de usuário.
- Clique em Reset My Password (Redefinir minha senha).
Isso envia um email para o endereço associado ao seu nome de usuário.
- Clique no link no email.
- Insira uma nova senha, confirme-a e clique em Change Password (Alterar senha).
Salve seu nome de usuário e senha para usar mais adiante neste projeto.
Configurar o compartilhamento de recurso entre origens no Salesforce
O CORS (compartilhamento de recurso entre origens) permite a execução de código em um navegador da web para comunicação com o Salesforce de uma origem específica. Vamos adicionar os padrões de URL para Postman.
- Em seu Trailhead Playground, em Setup (Configuração), insira
cors
na caixa Quick Find (Busca rápida) e selecione CORS.
- Em Allowed Origins List (Lista Origens permitidas), clique em New (Novo).
- Insira
https://*.postman.com
como padrão de URL de origem.
- Clique em Save (Salvar).
- Selecione CORS novamente.
- Clique em New (Novo) e insira
https://*.postman.co
(observe a extensão de domínio .co) como padrão de URL de origem.
- Clique em Save (Salvar).
Seu Playground está pronto para você conectar o Postman a ele. Você fará isso na próxima etapa.
Recursos
- Site externo: Centro de aprendizagem do Postman
- GitHub: APIs do Salesforce para Postman
- GitHub: Como instalar com a IU Web do Postman
- YouTube: Usar a coleção de APIs do Salesforce com a IU Web do Postman | Atalhos do desenvolvedor
- Ajuda do Salesforce: Qual API eu uso?
- Trailhead: Cliente API do Postman