Een Postman-collectie voor een aangepaste connector maken

Notitie

Dit onderwerp maakt deel uit van een zelfstudiereeks over het maken en gebruiken van aangepaste connectoren voor Microsoft Copilot Studio, Azure Logic Apps, Microsoft Power Automate en Microsoft Power Apps. Zorg ervoor dat u het overzicht van de aangepaste connector leest om het proces te begrijpen.

Postman is een app voor het doen van HTTP-verzoeken. Met Postman collecties kunt u gerelateerde API-verzoeken organiseren en groeperen. Collecties kunnen de ontwikkeling van aangepaste connectoren sneller en gemakkelijker maken als u nog geen OpenAPI-definitie voor uw API hebt.

In dit artikel maakt u een verzameling met een aanvraag en respons van Tekstanalyse-API van Azure Cognitive Services. In een gerelateerd onderwerp maakt u een connector met behulp van deze verzameling.

Vereisten

• De Postbode app
• Een API-sleutel voor de Cognitive Services Text Analytics API

Een HTTP-aanvraag maken voor de API

1. Selecteer in Postman op het tabblad Builder de HTTP-methode, voer de aanvraag-URL voor het API-eindpunt in en selecteer een autorisatieprotocol, indien van toepassing.

   

   Parameter	Weergegeven als
   HTTP-methode	POSTEN
   Aanvraag-URL	https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment
   Autorisatie	Geen autorisatie (in de volgende stap geeft u een API-sleutel op)

2. Voer sleutel-waardeparen voor de aanvraagheader in. Voor veelvoorkomende HTTP-headers kunt u selecteren in de vervolgkeuzelijst.

   

   Key	Weergegeven als
   Ocp-Apim-Subscription-Key	Uw API-abonnementssleutel, die u kunt vinden in uw Cognitive Services-account
   Inhoud-Type	application/json

3. Voer inhoud in die u wilt verzenden in de aanvraagtekst. Om te controleren of het verzoek werkt door een antwoord terug te krijgen, selecteert u Verzenden.

   

   {
       "documents": [{
           "language": "en-us",
           "id": "1", 
           "text": "I enjoyed the new movie after a long day."
       }]
   }
   

   Het responsveld bevat de volledige respons van de API, die het resultaat bevat of een fout, indien er een fout is opgetreden.

   

De collectie opslaan

1. Selecteer Opslaan.

   

2. Voer in het dialoogvenster Aanvraag opslaan een aanvraagnaam en beschrijving in. De aangepaste connector gebruikt deze waarden voor het bewerkingsoverzicht en de beschrijving van de API.

   

   Parameter	Weergegeven als
   Aanvraagnaam	DetectSentiment
   Beschrijving van aanvraag	De API retourneert een numerieke score tussen 0 en 1. Scores dicht bij 1 duiden op een positief gevoel en scores dicht bij 0 op een negatief gevoel.

3. Selecteer + Collectie maken en voer een naam in voor de collectie. De aangepaste connector gebruikt deze waarde als u de API aanroept. Selecteer het vinkje (✓), waarmee een verzamelmap wordt gemaakt, en selecteer vervolgens Opslaan in SentimentDemo.

   

   Parameter	Weergegeven als
   Naam van collectie	SentimentDemo

Sla de respons voor de aanvraag op

Nu u de aanvraag hebt opgeslagen, kunt u de respons opslaan. Op deze manier wordt de respons weergegeven als voorbeeld wanneer u de aanvraag later laadt.

1. Selecteer boven het antwoordvenster Antwoord opslaan.

   

   Aangepaste connectors ondersteunen slechts één respons per aanvraag. Als u meerdere responsen per aanvraag opslaat, wordt alleen de eerste gebruikt.

2. Voer bovenaan de app een naam in voor uw voorbeeldantwoord en selecteer vervolgens Voorbeeld opslaan.

   

Als de API extra functies heeft, kunt u nu doorgaan met het uitbreiden van de Postman-verzameling met eventuele aanvullende aanvragen en responsen.

De Postman-collectie exporteren

U kunt de collectie nu als een JSON-bestand exporteren, dat u importeert met de wizard voor aangepaste connectors. Voordat u de verzameling exporteert, verwijdert u de headers voor het inhoudstype en de beveiliging. Deze waren vereist om API-aanvragen te doen, maar worden anders verwerkt in de aangepaste connector.

1. Beweeg op het tabblad Kopteksten de muisaanwijzer over elke koptekst en selecteer de X naast de koptekst om deze te verwijderen. Selecteer Opslaan om de verzameling opnieuw op te slaan.

   

2. Selecteer de ellips (…) naast de verzameling en selecteer vervolgens Exporteren.

   

3. Selecteer het exportformaat Collection v1 , selecteer Exporteren en blader vervolgens naar de locatie waar u het JSON-bestand wilt opslaan.

   

   Notitie

   Momenteel kunt u alleen v1-collecties gebruiken voor aangepaste connectors.

Volgende stappen

U bent nu klaar om een aangepaste connector te definiëren op basis van de Postman-collectie die u hebt gemaakt:

• Maak een aangepaste connector uit een Postman-collectie

Feedback geven

We stellen feedback over problemen met ons connectorplatform of ideeën voor nieuwe functies zeer op prijs. Als u feedback wilt geven, gaat u naar Problemen indienen of hulp krijgen met connectoren en selecteert u het type feedback.