Opisywanie łącznika niestandardowego za pomocą narzędzia PostmanDescribe a custom connector with Postman

Postman to narzędzie służące do przyspieszania i ułatwiania programowania Twojego interfejsu API.Postman is a tool for making your API development faster and easier. Ten samouczek pokazuje, jak utworzyć kolekcję narzędzia Postman, która następnie umożliwia łatwe tworzenie łączników niestandardowych w usłudze PowerApps.This tutorial demonstrates how to create a Postman collection, which you can then use to easily create Custom connectors in PowerApps.

Wymagania wstępnePrerequisites

Tworzenie kolekcji narzędzia PostmanCreate a Postman Collection

Utwórzmy kolekcję narzędzia Postman dla interfejsu API analizy tekstu usługi Azure Cognitive Services.Let's build a Postman Collection for the Azure Cognitive Services Text Analytics API. Ten interfejs API umożliwia identyfikowanie języka, opinii i kluczowych fraz w przekazanym do niego tekście.This API identifies the language, sentiment, and key phrases in text that you pass to it.

  1. Pierwszym krokiem tworzenia kolekcji narzędzia Postman jest utworzenie żądania.The first step in creating a Postman Collection is to create a request. Podczas tworzenia żądania możesz ustawić zlecenie HTTP, adres URL żądania, parametry zapytania lub ścieżki, nagłówki i treść.When creating the request, you can set the HTTP verb, the request URL, query or path parameters, headers, and the body. Aby uzyskać więcej informacji, zobacz Sending Requests (Wysyłanie żądań) w dokumentacji narzędzia Postman.For more information, see Sending Requests in the Postman documentation. W przypadku punktu końcowego interfejsu API wykrywania języka ustaw wartości w następujący sposób:For the Detect Language API endpoint, set the values as follows:

    Żądanie narzędzia Postman

    Szczegóły użytych parametrów i wartości:Details of parameters and values used:

    ParametrParameter WartośćValue
    ZlecenieVerb POSTPOST
    Adres URL żądaniaRequest URL https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languageshttps://westus.api.cognitive.microsoft.com/text/analytics/v2.0/languages
    ParametryParams numberOfLanguagesToDetectnumberOfLanguagesToDetect
    AutoryzacjaAuthorization “No Auth”“No Auth”
    NagłówkiHeaders Ocp-Apim-Subscription-Key = Ocp-Apim-Subscription-Key =
    Content-Type = application/jsonContent-Type = application/json
    TreśćBody {
       "documents": [
         {
            "id": "1",
            "text": "Hello World"
         }
      ]
    }
  2. Kliknij przycisk Wyślij, aby wysłać żądanie i otrzymać zwrotnie odpowiedź.Click Send to make the request and get the response back.
  3. Kliknij przycisk Zapisz, aby zapisać żądanie do kolekcji narzędzia Postman.Click Save to save the request into a Postman Collection.

    Odpowiedź narzędzia Postman

  4. Podaj wartości dla pozycji Nazwa żądania i Opis żądania w oknie dialogowym Zapisywanie żądania.Provide a Request name and Request description in the Save Request dialog box. Użyjesz tych wartości w łączniku niestandardowym.You will use these values in your custom connector.

    Zapisywanie kolekcji narzędzia Postman

    Możesz także zapisać odpowiedź na żądanie.You can also save the response to the request. Łączniki niestandardowe obecnie obsługują tylko pojedynczą odpowiedź na żądanie.Custom connectors currently only support a single response per request. Jeśli zapiszesz wiele odpowiedzi na żądanie, będzie używana tylko pierwsza z nich.If you save multiple responses per request, only the first one is used.

    Zapisywanie odpowiedzi narzędzia Postman

  5. Kontynuuj tworzenie kolekcji narzędzia Postman, tworząc i zapisując inne żądania i odpowiedzi.Continue building your Postman Collection by creating and saving other requests and responses.
  6. Po zakończeniu tworzenia kolekcji narzędzia Postman dla wszystkich swoich żądań i odpowiedzi wyeksportuj kolekcję.Once you have completed building the Postman Collection for all your requests and responses, export the collection.

    Eksportowanie w narzędziu Postman

  7. Wybierz pozycję Kolekcja v1 jako format eksportu.Choose Collection v1 as the export format.

    Eksportowanie w narzędziu Postman

Możesz teraz użyć kolekcji narzędzia Postman do tworzenia łącznika niestandardowego w usłudze PowerApps.You can now use this Postman collection to create a custom connector in PowerApps. Aby uzyskać więcej informacji, zobacz Rejestrowanie i używanie łączników niestandardowych w usłudze PowerApps.For more information, see Register and use custom connectors in PowerApps.