Så här konfigurerar du Postman för Azure Digital Twins

Viktigt

En ny version av Azure Digital Twins-tjänsten har släppts. Mot bakgrund av den nya tjänstens utökade funktioner har den ursprungliga Azure Digital Twins-tjänsten (beskrivs i den här dokumentationsuppsättningen) dragits tillbaka.

Om du vill visa dokumentationen för den nya tjänsten går du till den aktiva Azure Digital Twins-dokumentationen.

Den här artikeln beskriver hur du konfigurerar Postman REST-klienten så att den interagerar med och testar Azure Digital Twins Management-API:erna. Mer specifikt beskrivs följande:

• Så här konfigurerar du ett Azure Active Directory-program så att det använder implicit beviljandeflöde för OAuth 2.0.
• Använda Postman REST-klienten för att göra tokenbärande HTTP-begäranden till dina hanterings-API:er.
• Använda Postman för att göra POST-begäranden i flera delar till dina hanterings-API:er.

Postman-sammanfattning

Kom igång med Azure Digital Twins med hjälp av ett REST-klientverktyg som Postman för att förbereda din lokala testmiljö. Postman-klienten hjälper till att snabbt skapa komplexa HTTP-begäranden. Ladda ned Postman-klientens skrivbordsversion genom att gå till www.getpostman.com/apps.

Postman är ett REST-testverktyg som hittar viktiga funktioner för HTTP-begäranden i ett användbart skrivbords- och plugin-baserat grafiskt användargränssnitt.

Via Postman-klienten kan lösningsutvecklare ange vilken typ av HTTP-begäran (POST, GET, UPDATE, PATCH och DELETE), API-slutpunkt som ska anropas och användning av TLS. Postman har också stöd för att lägga till HTTP-begärandehuvuden, parametrar, formulärdata och organ.

Konfigurera Azure Active Directory för att använda implicit beviljandeflöde för OAuth 2.0

1. Följ stegen i snabbstarten för att skapa och konfigurera ett Azure Active Directory-program. Du kan också återanvända en befintlig appregistrering.

   

2. Lägg nu till en omdirigerings-URI i https://www.getpostman.com/oauth2/callback.

3. Markera kryssrutan Implicit bevilja>åtkomsttoken så att OAuth 2.0 implicit beviljandeflöde kan användas. Välj Konfigurera och sedan Spara.

4. Kopiera klient-ID :t för din Azure Active Directory-app.

Hämta en OAuth 2.0-token

I exemplen nedan YOUR_MANAGEMENT_API_URL refererar till URI:n för Digital Twins-API:erna:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0

Name	Ersätt med
YOUR_INSTANCE_NAME	Namnet på din Azure Digital Twins-instans
YOUR_LOCATION	Den region som din instans finns i

Konfigurera Postman för att hämta en Azure Active Directory-token. Därefter gör du en autentiserad HTTP-begäran till Azure Digital Twins med hjälp av den förvärvade token:

1. Kontrollera att auktoriserings-URL:en är korrekt. Det bör ha formatet:

   https://login.microsoftonline.com/YOUR_AZURE_TENANT.onmicrosoft.com/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0
   

   Name	Ersätt med	Exempel
   YOUR_AZURE_TENANT	Namnet på din klientorganisation eller organisation. Använd det människovänliga namnet i stället för det alfanumeriska klientorganisations-ID: t för din Azure Active Directory-appregistrering.	microsoft

2. Gå till www.getpostman.com för att ladda ned appen.

3. Vi vill göra EN GET-begäran. Välj fliken Auktorisering , välj OAuth 2.0 och välj sedan Hämta ny åtkomsttoken.

   Fält	Värde
   Grant Type (Typ av beviljande)	Implicit
   Callback URL (Webbadress för återanrop)	https://www.getpostman.com/oauth2/callback
   Auth URL (Auktoriseringswebbadress)	Använd auktoriserings-URL:en från steg 1
   Klient-ID	Använd program-ID :t för Azure Active Directory-appen som skapades eller återanvänddes från föregående avsnitt
   Omfång	Lämna tomt
   Tillstånd	Lämna tomt
   Klientautentisering	Send as Basic Auth header

4. Klienten bör nu visas som:

   

5. Välj Request Token (Begär token).

6. Rulla nedåt och välj Använd token.

Skapa en POST-begäran med flera delar

När du har slutfört föregående steg konfigurerar du Postman för att göra en autentiserad POST-begäran för flera delar av HTTP:

1. Under fliken Rubriker lägger du till en HTTP-begärandehuvudnyckel Content-Type med värdet multipart/mixed.

   

2. Serialisera icke-textdata till filer. JSON-data sparas som en JSON-fil.

3. Under fliken Brödtext väljer du form-data.

4. Lägg till varje fil genom att tilldela ett nyckelnamn och Filevälja .

5. Välj sedan varje fil via knappen Välj fil .

   

   Anteckning

   • Postman-klienten kräver inte att segment i flera delar har en manuellt tilldelad innehållstyp eller innehållsdisposition.
   • Du behöver inte ange dessa rubriker för varje del.
   • Du måste välja multipart/mixed eller en annan lämplig innehållstyp för hela begäran.

6. Slutligen väljer du Skicka för att skicka din HTTP POST-begäran för flera delar. Statuskoden 200 eller 201 anger en lyckad begäran. Lämpligt svarsmeddelande visas i klientgränssnittet.

7. Verifiera dina HTTP POST-begärandedata genom att anropa API-slutpunkten:

   YOUR_MANAGEMENT_API_URL/spaces/blobs?includes=description
   

Nästa steg

• Mer information om Digital Twins-hanterings-API:er och hur du använder dem finns i Så här använder du Azure Digital Twins-hanterings-API:er.

• Använd begäranden med flera delar för att lägga till blobar i Azure Digital Twins-entiteter.

• Mer information om hur du autentiserar med API:er för hantering finns i Autentisera med API:er.