Delen via


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

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.

    Aanvraag maken:

    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.

    Vervolg aanvraag: Headers.

    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.

    Vervolg aanvraag:

    {
        "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.

    Aanvraagrespons ophalen.

De collectie opslaan

  1. Selecteer Opslaan.

    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.

    Schermopname met het venster Aanvraag opslaan.

    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.

    Schermopname met de stappen voor het maken van een collectie.

    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.

    Schermopname met het venster Respons 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.

    Schermopname die laat zien hoe u een voorbeeld kunt 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.

    Headers verwijderen.

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

    Collectie exporteren.

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

    Kies exportindeling:

    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:

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.