Descrever um conector personalizado com PostmanDescribe a custom connector with Postman

Postman é uma ferramenta para facilitar e agilizar o desenvolvimento de API.Postman is a tool for making your API development faster and easier. Este tutorial mostra como criar uma coleção Postman, que pode ser usada para criar conectores personalizados com facilidade 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 PostmanCreate a Postman Collection

Vamos criar uma Coleção 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. Essa API identifica o idioma, o sentimento e as frases-chave no texto que você passa para ela.This API identifies the language, sentiment, and key phrases in text that you pass to it.

  1. A primeira etapa na criação de uma Coleção Postman é criar uma solicitação.The first step in creating a Postman Collection is to create a request. Ao criar a solicitação, você pode definir o verbo HTTP, a URL de solicitação, 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, consulte Enviando solicitações na documentação do Postman.For more information, see Sending Requests in the Postman documentation. Para o ponto de extremidade de API de Detecção de Linguagem, defina os valores da seguinte maneira:For the Detect Language API endpoint, set the values as follows:

    Solicitação do Postman

    Detalhes de parâmetros e valores usados:Details of parameters and values used:

    ParâmetroParameter ValorValue
    VerboVerb POSTPOST
    URL de SolicitaçãoRequest 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 “Nenhuma Autenticação”“No Auth”
    CabeçalhosHeaders Ocp-Apim-Subscription-Key = Ocp-Apim-Subscription-Key =
    Content-Type = application/jsonContent-Type = application/json
    CorpoBody {
       "documents": [
         {
            "id": "1",
            "text": "Hello World"
         }
      ]
    }
  2. Clique em Enviar para fazer a solicitação e obter a resposta de volta.Click Send to make the request and get the response back.
  3. Clique em Salvar para salvar a solicitação em uma Coleção Postman.Click Save to save the request into a Postman Collection.

    Resposta do Postman

  4. Forneça um Nome da solicitação e uma Descrição da solicitação na caixa de diálogo Salvar Solicitação.Provide a Request name and Request description in the Save Request dialog box. Você usará esses valores no conector personalizado.You will use these values in your custom connector.

    Salvar a Coleção Postman

    Também é possível salvar a resposta à solicitação.You can also save the response to the request. Atualmente, os conectores personalizados dão suporte apenas a uma única resposta por solicitação.Custom connectors currently only support a single response per request. Se você salvar várias respostas por solicitação, somente a primeira delas será usada.If you save multiple responses per request, only the first one is used.

    Salvar resposta do Postman

  5. Continue criando sua Coleção Postman criando e salvando outras solicitações 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 Postman de todas as solicitações e respostas, exporte a coleção.Once you have completed building the Postman Collection for all your requests and responses, export the collection.

    Exportar o Postman

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

    Exportar o Postman

Agora você pode usar essa coleção 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, consulte Registrar e usar conectores personalizados no PowerApps.For more information, see Register and use custom connectors in PowerApps.