Oprette en Postman collection for en brugerdefineret connector

Postman er en app til HTTP-anmodninger, og Postman-samlinger hjælper dig med at organisere og gruppere relaterede API-anmodninger. Samlinger kan gøre udviklingen af brugerdefinerede connectorer hurtigere og nemmere, hvis du ikke allerede har en OpenAPI-definition for din API. Du kan finde flere oplysninger om samlinger under Oprettelse af samlinger i dokumentationen til Postman.

I denne emne opretter du en samling, der indeholder en anmodning og et svar fra Cognitive Services-Tekstanalyse-API. I et relateret emne skal du oprette en connector ved hjælp af denne samling.

Forudsætninger

• Appen Postman
• En API-nøgle til Tekstanalyse-API'en for Cognitive Services

Opret en HTTP-anmodning for API'en

1. Vælg HTTP-metoden under fanen Builder i Postman, angiv anmodnings-URL-adressen for API-slutpunktet, og vælg evt. en godkendelsesprotokol.

   

   Parameter	Værdi
   HTTP-metode	"POST"
   URL-adresse til anmodning	"https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment"
   Autorisation	"Ingen godkendelse" (du angiver en API-nøgle i det næste trin)

2. Angiv nøgleværdipar for anmodningsheaderen. I forbindelse med almindelige HTTP-headere kan du vælge på rullelisten.

   

   Nøgle	Værdi
   Ocp-Apim-Subscription-Key	din-API-abonnementsnøgle, som du finder på din Cognitive Services-konto
   Indholdstype	"application/json"

3. Angiv det indhold, der skal sendes i anmodningens brødtekst. Hvis du vil kontrollere, at anmodningen fungerer ved at få et svar, skal du vælge Send.

   

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

   Svarfeltet indeholder hele svaret fra API'en, herunder resultatet eller en fejl, hvis der opstod en fejl.

   

Du kan finde flere oplysninger om HTTP-anmodninger under Anmodninger i dokumentationen til Postman.

Gem samlingen

1. Vælg Gem.

   

2. Under Gem anmodning skal du angive et anmodningsnavn og en beskrivelse af anmodningen. Den brugerdefinerede connector bruger disse værdier til API-operationens oversigt og beskrivelse.

   

   Parameter	Værdi
   Anmodningsnavn	"DetectSentiment"
   Anmodningsbeskrivelse	"API'en returnerer en numerisk værdi mellem 0 og 1. Scorer tæt på 1 indikerer et positivt synspunkt, mens scorer tæt på 0 indikerer et negativt synspunkt".

3. Vælg + Opret samling, og angiv et navn på samlingen. Den brugerdefinerede connector bruger denne værdi, når du kalder API'en. Vælg markeringen, som opretter en samlingsmappe, og vælg derefter Gem til SentimentDemo.

   

   Parameter	Værdi
   Samlingsnavn	"SentimentDemo"

Gem anmodningssvaret

Nu hvor du har gemt din anmodning, kan du gemme svaret. På denne måde vises svaret som et eksempel, når du indlæser anmodningen senere.

1. Vælg Gem svar over svarvinduet.

   

   Brugerdefinerede connectorer understøtter kun ét svar pr. anmodning. Hvis du gemmer flere svar pr. anmodning, er det kun det første svar, der bruges.

2. Øverst i appen skal du angive et navn på dit svareksempel og vælge Gem eksempel.

   

Hvis din API havde yderligere funktioner, ville du fortsætte med at oprette din Postman-samling med yderligere anmodninger og svar.

Eksportér Postman-samlingen

Du kan nu eksportere samlingen som en JSON-fil, som du derefter importerer ved hjælp af guiden til brugerdefinerede connectorer. Før du eksporterer samlingen, skal du fjerne overskrifterne for indholdstype og sikkerhed. De var nødvendige for at foretage API-anmodninger, men de håndteres anderledes i den brugerdefinerede connector.

1. Under Overskrifter skal du holde markøren over hver overskrift og vælge X ud for overskriften for at fjerne den. Vælg Gem for at gemme samlingen igen.

   

2. Vælg ellipsen (. . . .) ud for samlingen, og vælg derefter Eksportér.

   

3. Vælg eksportformatet Collection v1, vælg Exportér, og gå derefter til den placering, hvor du vil gemme JSON-filen.

   

   Bemærk

   I øjeblikket kan du kun bruge v1-samlinger til brugerdefinerede connectorer.

Næste trin

Du er nu klar til at oprette en brugerdefineret connector baseret på den Postman-samling, du har oprettet:

• Opret en brugerdefineret connector fra en Postman-samling