Postman é uma ferramenta para facilitar e agilizar o desenvolvimento de API. Este tutorial mostra como criar uma coleção Postman, que pode ser usada para criar conectores personalizados com facilidade no PowerApps.

Pré-requisitos

Criar uma Coleção Postman

Vamos criar uma Coleção Postman para a API de Análise de Texto dos Serviços Cognitivos do Azure. Essa API identifica o idioma, o sentimento e as frases-chave no texto que você passa para ela.

  1. A primeira etapa na criação de uma Coleção Postman é criar uma solicitação. 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. Para obter mais informações, consulte Enviando solicitações na documentação do Postman. Para o ponto de extremidade de API de Detecção de Linguagem, defina os valores da seguinte maneira:

    Solicitação do Postman

    Detalhes de parâmetros e valores usados:

    Parâmetro Valor
    Verbo POST
    URL de Solicitação https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languages
    Parâmetros numberOfLanguagesToDetect
    Autorização “Nenhuma Autenticação”
    Cabeçalhos Ocp-Apim-Subscription-Key =
    Content-Type = application/json
    Corpo {
       "documents": [
         {
            "id": "1",
            "text": "Hello World"
         }
      ]
    }
  2. Clique em Enviar para fazer a solicitação e obter a resposta de volta.

  3. Clique em Salvar para salvar a solicitação em uma Coleção Postman.

    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. Você usará esses valores no conector personalizado.

    Salvar a Coleção Postman

    Também é possível salvar a resposta à solicitação. Atualmente, os conectores personalizados dão suporte apenas a uma única resposta por solicitação. Se você salvar várias respostas por solicitação, somente a primeira delas será usada.

    Salvar resposta do Postman

  5. Continue criando sua Coleção Postman criando e salvando outras solicitações e respostas.

  6. Depois de concluir a criação da Coleção Postman de todas as solicitações e respostas, exporte a coleção.

    Exportar o Postman

  7. Escolha Coleção v1 como o formato de exportação.

    Exportar o Postman

Agora você pode usar essa coleção Postman para criar um conector personalizado no PowerApps. Para obter mais informações, consulte Registrar e usar conectores personalizados no PowerApps.