Descreva um conector personalizado com o PostmanDescribe a custom connector with Postman

O Postman é uma ferramenta para tornar o desenvolvimento de APIs mais rápido e fácil.Postman is a tool for making your API development faster and easier. Este tutorial demonstra como criar uma coleção do Postman, que, em seguida, pode utilizar para criar facilmente Conectores personalizados no PowerApps.This tutorial demonstrates how to create a Postman collection, which you can then use to easily create Custom connectors in PowerApps.

Pré-requisitosPrerequisites

Criar uma Coleção do PostmanCreate a Postman Collection

Vamos criar uma Coleção do Postman para a API de Análise de Texto dos Serviços Cognitivos do Azure.Let's build a Postman Collection for the Azure Cognitive Services Text Analytics API. Esta API identifica o idioma, o sentimento e as expressões-chave no texto transmitido.This API identifies the language, sentiment, and key phrases in text that you pass to it.

  1. O primeiro passo na criação de uma Coleção do Postman é criar um pedido.The first step in creating a Postman Collection is to create a request. Ao criar o pedido, pode definir o verbo HTTP, o URL do pedido, os parâmetros de consulta ou de caminho, os cabeçalhos e o corpo.When creating the request, you can set the HTTP verb, the request URL, query or path parameters, headers, and the body. Para obter mais informações, veja Enviar Pedidos na documentação do Postman.For more information, see Sending Requests in the Postman documentation. Para o ponto final da API Detetar Idioma, defina os valores da seguinte forma:For the Detect Language API endpoint, set the values as follows:

    Pedido do Postman

    Detalhes dos parâmetros e valores utilizados:Details of parameters and values used:

    ParâmetroParameter ValorValue
    VerboVerb PUBLICARPOST
    URL do pedidoRequest URL https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languageshttps://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languages
    ParâmetrosParams numberOfLanguagesToDetectnumberOfLanguagesToDetect
    AutorizaçãoAuthorization “Sem autenticação”“No Auth”
    CabeçalhosHeaders Ocp-Apim-Subscription-Key = Ocp-Apim-Subscription-Key =
    Tipo de conteúdo = aplicação/jsonContent-Type = application/json
    CorpoBody {
       "documents": [
         {
            "id": "1",
            "text": "Hello World"
         }
      ]
    }
  2. Clique em Enviar para fazer o pedido e obter a resposta.Click Send to make the request and get the response back.
  3. Clique em Guardar para guardar o pedido numa Coleção do Postman.Click Save to save the request into a Postman Collection.

    Resposta do Postman

  4. Indique um Nome do pedido e uma Descrição do pedido na caixa de diálogo Guardar Pedido.Provide a Request name and Request description in the Save Request dialog box. Irá utilizar estes valores no conector personalizado.You will use these values in your custom connector.

    Guardar Coleção do Postman

    Também pode guardar a resposta no pedido.You can also save the response to the request. Atualmente, os conectores personalizados só suportam uma única resposta por pedido.Custom connectors currently only support a single response per request. Se guardar várias respostas por pedido, apenas a primeira será utilizada.If you save multiple responses per request, only the first one is used.

    Guardar Resposta do Postman

  5. Continue a criar a Coleção do Postman ao criar e guardar outros pedidos e respostas.Continue building your Postman Collection by creating and saving other requests and responses.
  6. Depois de concluir a criação da Coleção do Postman para todos os pedidos e respostas, exporte a coleção.Once you have completed building the Postman Collection for all your requests and responses, export the collection.

    Exportação do Postman

  7. Escolha a Coleção v1 como o formato de exportação.Choose Collection v1 as the export format.

    Exportação do Postman

Agora, pode utilizar esta coleção do Postman para criar um conector personalizado no PowerApps.You can now use this Postman collection to create a custom connector in PowerApps. Para obter mais informações, veja Registar e utilizar conectores personalizados no PowerApps.For more information, see Register and use custom connectors in PowerApps.