Een Postman-collectie voor een aangepaste connector maken

  • Artikel

Notitie

Dit onderwerp maakt deel uit van een reeks zelfstudies over het maken en gebruiken van aangepaste connectors in Azure Logic Apps, Power Automate en Power Apps. Zorg ervoor dat u het overzicht van aangepaste connectors leest om het proces te begrijpen.

Postman is een app voor het maken van HTTP-aanvragen en Postman-collecties helpen u bij het organiseren en groeperen van gerelateerde API-aanvragen. Collecties kunnen de ontwikkeling van aangepaste connectoren sneller en gemakkelijker maken als u nog geen OpenAPI-definitie voor uw API hebt. Zie Collecties maken in de Postman-documentatie voor meer informatie over collecties.

In dit onderwerp maakt u een collectie met een aanvraag en respons van de Azure Cognitive Services Text Analytics API. In een gerelateerd onderwerp maakt u een connector met behulp van deze collectie.

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 eventueel een autorisatieprotocol.

    Aanvraag maken: "HTTP-methode", "Aanvraag-URL", "Autorisatie".

    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. Deze vindt u in uw Cognitive Services-account.
    Inhoud-Type application/json

  3. Voer inhoud in die u wilt verzenden in de aanvraagtekst. Selecteer Verzenden om te controleren of de aanvraag werkt en u een respons ontvangt.

    Vervolg aanvraag: "Body".

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

Ga naar Aanvragen in de Postman-documentatie voor meer informatie over HTTP-aanvragen.

De collectie opslaan

  1. Selecteer Save.

    Selecteer Opslaan.

  2. Voer in het dialoogvenster Aanvraag opslaan een aanvraagnaam en een beschrijving voor de aanvraag op. 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 voor de collectie in. De aangepaste connector gebruikt deze waarde als u de API aanroept. Selecteer het vinkje (✓) waarmee een collectiemap wordt gemaakt. 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 responsvenster de optie Respons 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 boven aan de app een naam in voor uw voorbeeldrespons en selecteer vervolgens Voorbeeld opslaan.

    Schermopname die laat zien hoe u een voorbeeld kunt opslaan.

Als uw API extra functies heeft, kunt u: doorgaan met het maken van uw Postman-collectie 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 collectie exporteert, verwijdert u eerst het inhoudstype en de beveiligingsheaders. Deze waren vereist om API-aanvragen te maken, maar worden in de aangepaste connector anders verwerkt.

  1. Wijs op het tabblad Headers elke header aan en selecteer de X naast de header om deze te verwijderen. Selecteer Opslaan om de collectie opnieuw op te slaan.

    Headers verwijderen.

  2. Selecteer het beletselteken (…) naast de collectie en selecteer vervolgens Exporteren.

    Collectie exporteren.

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

    Kies exportindeling: "Collectie v1".

    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. Om feedback te geven, gaat u naar Problemen melden of hulp krijgen met connectoren en selecteer uw feedbacktype.