Benutzerdefinierten Connector mit Postman beschreibenDescribe a custom connector with Postman

Postman ist ein Tool, das Ihre API-Entwicklung schneller und einfacher machen kann.Postman is a tool for making your API development faster and easier. Dieses Tutorial zeigt das Erstellen einer Postman-Sammlung, die Sie dann verwenden können, um auf einfache Weise Benutzerdefinierte Connectors in PowerApps zu erstellen.This tutorial demonstrates how to create a Postman collection, which you can then use to easily create Custom connectors in PowerApps.

VoraussetzungenPrerequisites

Erstellen einer Postman-SammlungCreate a Postman Collection

Erstellen wir gemeinsam eine Postman-Sammlung für die Textanalyse-API aus Azure Cognitive Services.Let's build a Postman Collection for the Azure Cognitive Services Text Analytics API. Diese API bestimmt die Sprache, die Stimmung und wichtige Aussagen in den Texten, die Sie ihr übergeben.This API identifies the language, sentiment, and key phrases in text that you pass to it.

  1. Der erste Schritt beim Erstellen einer Postman-Sammlung besteht im Erstellen einer Anforderung.The first step in creating a Postman Collection is to create a request. Beim Erstellen der Anforderung können Sie das HTTP-Verb, die Anforderungs-URL, Abfrage- oder Pfadparameter, Header und den Anforderungstext festlegen.When creating the request, you can set the HTTP verb, the request URL, query or path parameters, headers, and the body. Weitere Informationen finden Sie in der Postman-Dokumentation unter Senden von Anforderungen (Sending Requests).For more information, see Sending Requests in the Postman documentation. Legen Sie für den Endpunkt der Spracherkennungs-API die folgenden Werte fest:For the Detect Language API endpoint, set the values as follows:

    Postman-Anforderung

    Details der verwendeten Parameter und Werte:Details of parameters and values used:

    ParameterParameter WertValue
    VerbVerb POSTPOST
    Anforderungs-URLRequest URL https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languageshttps://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languages
    ParamsParams AnzahlDerZuErkennendenSprachennumberOfLanguagesToDetect
    AutorisierungAuthorization „Keine Authentifizierung““No Auth”
    HeaderHeaders Ocp-Apim-Subscription-Key = Ocp-Apim-Subscription-Key =
    Content-Type = application/jsonContent-Type = application/json
    TextkörperBody {
       "documents": [
         {
            "id": "1",
            "text": "Hello World"
         }
      ]
    }
  2. Klicken Sie auf Senden, um die Anforderung einzuleiten und die Rückantwort zu erhalten.Click Send to make the request and get the response back.
  3. Klicken Sie auf Speichern, um die Anforderung in einer Postman-Sammlung zu speichern.Click Save to save the request into a Postman Collection.

    Postman-Antwort

  4. Geben Sie im Dialogfeld Speichern einen Anforderungsnamen und eine Anforderungsbeschreibung ein.Provide a Request name and Request description in the Save Request dialog box. Diese Werte werden in Ihrem benutzerdefinierten Connector verwendet.You will use these values in your custom connector.

    Sammlung speichern in Postman

    Sie können darüber hinaus auch die Antwort auf die Anforderung speichern.You can also save the response to the request. Benutzerdefinierte Connectors unterstützen zurzeit nur eine einzelne Antwort pro Anforderung.Custom connectors currently only support a single response per request. Wenn Sie auf eine Anforderung mehrere Antworten erhalten, wird nur die erste verwendet.If you save multiple responses per request, only the first one is used.

    Antwort speichern in Postman

  5. Fahren Sie mit dem Erstellen Ihrer Postman-Sammlung fort, indem Sie weitere Anforderungen und Antworten speichern.Continue building your Postman Collection by creating and saving other requests and responses.
  6. Nachdem Sie das Erstellen der Postman-Sammlung für Ihre sämtlichen Anforderungen und Antworten abgeschlossen haben, exportieren Sie die Sammlung.Once you have completed building the Postman Collection for all your requests and responses, export the collection.

    Postman-Export

  7. Wählen Sie als Exportformat Collection v1 aus.Choose Collection v1 as the export format.

    Postman-Export

Jetzt können Sie diese Postman-Sammlung verwenden, um einen benutzerdefinierten Connector in PowerApps zu erstellen.You can now use this Postman collection to create a custom connector in PowerApps. Weitere Informationen finden Sie unter Registrieren und Verwenden von benutzerdefinierten Connectors in PowerApps.For more information, see Register and use custom connectors in PowerApps.