Use o Postman com a API do Microsoft GraphUse Postman with the Microsoft Graph API

Você pode usar a coleção do Microsoft Graph Postman para começar a usar as APIs do Microsoft Graph em questão minutos.You can use the Microsoft Graph Postman collection to get started with Microsoft Graph APIs in minutes.

Imagem do Postman

Este artigo explica como começar a usar o Postman e o Microsoft Graph.This article explains how to get up and running with Postman and Microsoft Graph. Você também pode explorar as APIs do Microsoft Graph diretamente em seu navegador da Web usando o Explorador do Graph.You can also explore Microsoft Graph APIs directly in your web browser by using Graph Explorer.

Acessando a coleçãoAccessing the collection

Você pode acessar a coleção no Postman de duas maneiras: adquirindo-o ou contribuindo para ele.You can access the collection in Postman in two ways: by consuming it or by contributing to it. Primeiro, o Postman precisará estar em execução no seu computador.You will need to have Postman running on your computer first.

Adquirir a coleçãoConsume the collection

Adquirir a coleção é a maneira mais fácil de começar a usar as APIs do Microsoft Graph.Consuming the collection is the easiest way to get started with Microsoft Graph APIs. Para importar as coleções do Postman:To import the Postman collections:

  1. Baixe e registre-se no Postman.Download and register for Postman.

  2. Selecione Arquivo | Importar ....Choose File | Import ....

  3. Selecione Importar do link.Select Import From Link.

  4. Cole os dois URLs a seguir e selecione Importar após cada um.Paste the following two URLs and choose Import after each.

      https://raw.githubusercontent.com/microsoftgraph/microsoftgraph-postman-collections/master/Microsoft%20Graph.postman_collection.json
    
    
      https://raw.githubusercontent.com/microsoftgraph/microsoftgraph-postman-collections/master/Microsoft%20Graph.postman_environment.json
    
    

Você deverá ver o ambiente do Microsoft Graph na lista suspensa do ambiente na parte superior direita, próximo ao ícone de olho.You should now see the Microsoft Graph environment in the top right environment drop down by the eye icon. Agora, você precisará configurar o seu ambiente.Now you need to set up your environment.

Usando a coleçãoUsing the collection

Após obter a coleção do Microsoft Graph e o ambiente do Microsoft Graph no Postman, siga estas etapas.After you have the Microsoft Graph collection and the Microsoftr Graph environment in Postman, follow these steps.

Configure as chamadas de API do aplicativoSet up application API calls

  1. Escolha a opção Sem ambiente na lista suspensa na parte superior direita.Choose the No environment drop down in top right corner.

  2. Selecione ambiente do Microsoft Graph.Select Microsoft Graph environment.

  3. Selecione o ícone de olho à direita e, em seguida, Editar.Choose the eye icon to the right and then choose Edit.

  4. Insira o seu aplicativo da plataforma de identidade da Microsoft nas variáveis atuais (e não iniciais): ClientID, ClientSecret e TenantID.Enter your Microsoft Identity Application in the current (not initial) variables: ClientID, ClientSecret and TenantID. Para obter mais informações sobre como criar um aplicativo e autorizar o fluxo único do aplicativo, confira a postagem do blog Usar o Postman para fazer chamadas do Microsoft Graph.For more information about how to create an application and to admin consent the app-only flow, see the Use Postman to make Microsoft Graph calls blog post.

  5. Selecione Atualizar.Select Update. Feche a caixa de diálogo Gerenciar Ambientes.Close the Manage Environments dialog box. Na coleção do Microsoft Graph | Aplicativo no lado esquerdo, selecione Obter Token de Acesso Único do Aplicativo.In the MicrosoftGraph | Application collection on left side, choose Get App-only Access Token. Em seguida, no lado direito, selecione Enviar.Then choose Send on the right.

  6. Expanda a pasta Aplicativo | Usuários e selecione Obter Usuários.Expand the Application | Users folder and choose Get Users. Em seguida, clique em Enviar.Then choose Send.

Agora você está pronto para usar as coleções do Microsoft Graph.You are now up and running with the Microsoft Graph collections.

Observação: se você deseja executar outras APIs na coleção, você precisará concordar com as permissões necessárias do seu aplicativo.Note: If you want to run other APIs in the collection, you will need to consent the required permissions for your application.

Configurar as chamadas de API em nome deSet up on-behalf-of API calls

A maneira mais simples de configurar chamadas de APIs em nome de é fornecer um UserName e UserPassword nas configurações de ambiente e usar o Em Nome de um Usuário | Obter Token de Acesso do Usuário.The simplest way to set up on-behalf-of API calls is to provide a UserName and UserPassword in the environment settings and use the On Behalf of a User | Get User Access Token.

Importante: não recomendamos o uso de contas de usuário de produção, pois essas informações são armazenadas diretamente no Postman.Important: We don't recommend using production user accounts because this information is stored directly in Postman. Também não recomendamos o uso deste método para obter tokens de acesso na produção.We also don't recommend using this approach to obtain access tokens in production. Use-o apenas para fins de teste.Use it only for testing purposes.

Se você não deseja armazenar nomes de usuário e senhas em variáveis de ambiente que sincronizam com a sua conta de nuvem do Postman, é possível usar a função Obter Novo Token de Acesso para obter um token sem sair do Postman.If you don't want to store user names and passwords in environment variables that sync to your Postman cloud account, you can use the Get New Access Token capability to get a token without leaving Postman.

  1. Selecione Em nome de um Usuário | Obter Token de Acesso usando o Postman.Select On behalf of a User | Get Access Token using Postman.

  2. Selecione a guia Autorização.Choose the Authorization tab.

  3. Selecione o botão obter token de acesso.Choose the get access token button.

  4. Preencha os campos a seguir com os seus valores reais de locatário e aplicativo.Fill out the following boxes with your real tenant and application values. Note que aqui você não poderá usar as variáveis de ambiente; você terá que usar os valores reais.Note that you cannot use the environment variables here; you have to use the actual values. Eles podem ser encontrados selecionando EndPoints na lâmina do aplicativo em portal.azure.com.You can find them by selecting EndPoints in the application blade in portal.azure.com.

  5. Selecione Solicitar Token.Choose Request Token. Você deverá ver um prompt de interface de usuário para entrar e autorizar permissões.You should see a UI prompt to sign in and consent permissions.

  6. Copie o token de acesso, abra as suas variáveis de ambiente e cole-o no campo UserAccessToken.Copy the access token, open your environment variables, and paste it into the UserAccessToken field.

Agora todas as suas solicitações irão funcionar.Now all your requests will work.

Contribua para a coleçãoContribute to the collection

Se você desejar contribuir com suas próprias solicitações, você precisará bifurcar o repositório github das coleções do Microsoft Graph Postman.If you want to contribute your own requests, you will need to fork the Microsoft Graph Postman collections github repo.

Para detalhes sobre como fazer isso, assista ao vídeo a seguir.For details about how to do this, watch the following video.