Skapa ett anpassat anslutningsprogram från en Postman-samling

Postman är en app för att göra HTTP-förfrågningar och Postman samlingar hjälper dig att organisera och gruppera relaterade API-begäranden. Samlingar kan snabba på och förenkla utvecklingen av anpassade kopplingar om du inte har en OpenAPI-definition för ditt API. Mer information om samlingar finns i skapa samlingar i Postman-dokumentationen.

I det här ämnet skapar du en samling som innehåller en förfrågan och ett svar från Cognitive Services textanalys-API. I en relaterad ämne skapar du en kontakt med den här samlingen.

Förutsättningar

• Appen Postman
• En API-nyckel för API:et för textanalys i Cognitive Services

Skapa en HTTP-begäran för API:et

1. Gå till fliken Builder i Postman, välj HTTP-metoden, ange begärans-URL för API-slutpunkten och välj ett auktoriseringsprotokoll om det finns något.

   

   Parameter	Värde
   HTTP-metod	"SKICKA"
   Begäran-URL	"https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment"
   Auktorisering	”No Auth” (du anger en API-nyckel i nästa steg)

2. Ange nyckel/värde-par för begäranshuvudet. För vanliga HHTP-huvuden kan du välja från listrutan.

   

   Tangent	Värde
   Ocp-Apim-Subscription-Key	din-API-prenumerationsnyckel som du hittar i ditt Cognitive Services-konto
   Content-Type	"application/json"

3. Ange innehåll som du vill skicka i begäranstexten. Om du vill kontrollera att begäran fungerar genom att få tillbaka ett svar kan du välja Skicka.

   

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

   Svarsfältet innehåller det fullständiga svaret från API: et, inklusive resultatet eller ett fel om något sådant uppstod.

   

Mer information om HTTP-begäran finns i begäran i Postman-dokumentationen.

Spara samlingen

1. Välj Spara.

   

2. Under Spara begäran ska du ange ett namn och en beskrivning av begäran. Den anpassade anslutningsappen använder dessa värden för API-åtgärdens sammanfattning och beskrivning.

   

   Parameter	Värde
   Namn på begäran	"IdentifieraSentiment"
   Beskrivning av begäran	"API:n returnerar en numerisk poäng mellan 0 och 1. Poäng nära 1 visar en positiv attityd, medan en poäng nära 0 indikerar en negativ attityd."

3. Välj + Skapa samling och ange ett samlingsnamn. Den anpassade anslutningsappen använder det här värdet när du anropar API:et. Välj bockmarkeringen, vilket skapar en samlingsmapp. Välj sedan Save to SentimentDemo (Spara i SentimentDemo).

   

   Parameter	Värde
   Samlingsnamn	”SentimentDemo”

Spara svaret

Nu när du har sparat begäran kan du spara svaret. På så sätt visas svaret som ett exempel när du läser in begäran senare.

1. Välj Spara svar ovanför svarsfönstret.

   

   Anpassade anslutningsappar kan endast hantera ett svar per begäran. Om du sparar flera svar per förfrågan så används bara det första.

2. Ange ett namn för ditt exempelsvar högst upp i appen och välj Spara exempel.

   

Om API:et har fler funktioner skulle du fortsätta att bygga din Postman-samling med eventuella ytterligare begäranden och svar.

Exportera Postman-samlingen

Nu kan du exportera samlingen som en JSON-fil som du sedan importerar med hjälp av guiden för anpassade kopplingar. Innan du exporterar samlingen ska du ta bort innehållstyps- och säkerhetshuvuden—krävdes för att skapa API-begäran, men de hanteras annorlunda i den anpassade anslutningen.

1. Under Rubriker, håll muspekaren över varje rubrik och välj X bredvid rubriken för att ta bort den. Välj Save (Spara) för att spara samlingen igen.

   

2. Välj ellipsen (...) bredvid samlingen och välj sedan Exportera.

   

3. Välj exportformatet Collection v1, välj Export och bläddra till den plats där du vill spara JSON-filen.

   

   Anteckning

   För närvarande kan du endast använda Collection v1 för anpassade kopplingar.

Nästa steg

Du är nu redo att definiera en anpassad koppling som bygger på den Postman-samling som du skapade:

• Skapa ett anpassat anslutningsprogram från en Postman-samling