Konfigurace nástroje Postman pro Azure Digital Twins

Důležité

Byla vydána nová verze služby Azure Digital Twins. Vzhledem k rozšířeným možnostem nové služby se původní služba Azure Digital Twins (popsaná v této sadě dokumentace) vyřadila z provozu.

Pokud chcete zobrazit dokumentaci k nové službě, navštivte aktivní dokumentaci ke službě Azure Digital Twins.

Tento článek popisuje, jak nakonfigurovat klienta REST Postman pro interakci a testování rozhraní API pro správu služby Azure Digital Twins. Konkrétně popisuje:

• Jak nakonfigurovat aplikaci Azure Active Directory tak, aby používala implicitní tok udělení OAuth 2.0.
• Jak použít klienta Postman REST k vytváření požadavků HTTP nesoucích tokeny na vaše rozhraní API pro správu.
• Použití nástroje Postman k vytváření žádostí POST s více částmi pro rozhraní API pro správu

Souhrn postmanu

Začněte se službou Azure Digital Twins pomocí klientského nástroje REST, jako je Postman , a připravte místní testovací prostředí. Klient Postman pomáhá rychle vytvářet složité požadavky HTTP. Stáhněte si desktopovou verzi klienta Postman tak, že přejdete na www.getpostman.com/apps.

Postman je testovací nástroj REST, který vyhledá klíčové funkce požadavků HTTP do užitečného grafického uživatelského rozhraní založeného na desktopu a modulu plug-in.

Prostřednictvím klienta Postman můžou vývojáři řešení určit typ požadavku HTTP (POST, GET, UPDATE, PATCH a DELETE), koncový bod rozhraní API pro volání a použití protokolu TLS. Postman také podporuje přidání hlaviček požadavků HTTP, parametrů, dat formuláře a těla.

Konfigurace Azure Active Directory pro použití implicitního toku udělení OAuth 2.0

1. Postupujte podle kroků v rychlém startu a vytvořte a nakonfigurujte aplikaci Azure Active Directory. Případně můžete znovu použít existující registraci aplikace.

   

2. Nyní přidejte identifikátor URI pro přesměrování do https://www.getpostman.com/oauth2/callbacksouboru .

3. Zaškrtněte políčko Implicitní udělení>přístupových tokenů , abyste umožnili použití implicitního toku udělení OAuth 2.0. Vyberte Konfigurovat a pak Uložit.

4. Zkopírujte ID klienta vaší aplikace Azure Active Directory.

Získání tokenu OAuth 2.0

V následujících YOUR_MANAGEMENT_API_URL příkladech se odkazuje na identifikátor URI rozhraní API služby Digital Twins:

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

Name	Nahradit hodnotou
YOUR_INSTANCE_NAME	Název vaší instance Azure Digital Twins
YOUR_LOCATION	Oblast, ve které je vaše instance hostovaná

Nastavte a nakonfigurujte Nástroj Postman pro získání tokenu Azure Active Directory. Potom pomocí získaného tokenu proveďte ověřený požadavek HTTP pro službu Azure Digital Twins:

1. Ověřte správnost vaší autorizační adresy URL . Měl by mít formát:

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

   Name	Nahradit hodnotou	Příklad
   YOUR_AZURE_TENANT	Název vašeho tenanta nebo organizace. Místo alfanumerického ID tenanta registrace aplikace Azure Active Directory použijte popisný název.	microsoft

2. Přejděte na www.getpostman.com a stáhněte si aplikaci.

3. Chceme provést požadavek GET. Vyberte kartu Autorizace , vyberte OAuth 2.0 a pak vyberte Získat nový přístupový token.

   Pole	Hodnota
   Typ udělení	Implicit
   Adresa URL zpětného volání	https://www.getpostman.com/oauth2/callback
   Ověřovací adresa URL	Použití autorizační adresy URL z kroku 1
   ID klienta	Použijte ID aplikace pro aplikaci Azure Active Directory, která byla vytvořena nebo znovu použita z předchozí části.
   Obor	Ponechte prázdné
   Stav	Ponechte prázdné
   Ověření klienta	Send as Basic Auth header

4. Klient by se teď měl zobrazit takto:

   

5. Vyberte Request Token (Vyžádat token).

6. Posuňte se dolů a vyberte Použít token.

Vytvoření požadavku POST s více částmi

Po dokončení předchozích kroků nakonfigurujte Postman tak, aby vytvořil ověřený požadavek POST s více částmi HTTP:

1. Na kartě Hlavičky přidejte klíč hlavičky požadavku HTTP Content-Type s hodnotou multipart/mixed.

   

2. Serializovat netextová data do souborů. Data JSON by se uložila jako soubor JSON.

3. Pod kartou Text vyberte form-data.

4. Přidejte každý soubor tak, že přiřadíte název klíče a vyberete File.

5. Pak vyberte každý soubor pomocí tlačítka Zvolit soubor .

   

   Poznámka

   • Klient Postman nevyžaduje, aby bloky více částí měly ručně přiřazený typ obsahu nebo content-disposition.
   • Tyto hlavičky nemusíte zadávat pro každou část.
   • Pro celý požadavek musíte vybrat multipart/mixed nebo jiný odpovídající typ obsahu .

6. Nakonec vyberte Odeslat a odešlete požadavek HTTP POST s více částmi. Stavový kód 200 nebo 201 označuje úspěšný požadavek. V klientském rozhraní se zobrazí příslušná zpráva odpovědi.

7. Ověřte data požadavku HTTP POST voláním koncového bodu rozhraní API:

   YOUR_MANAGEMENT_API_URL/spaces/blobs?includes=description
   

Další kroky

• Informace o rozhraních API pro správu služby Digital Twins a o jejich používání najdete v tématu Jak používat rozhraní API pro správu služby Azure Digital Twins.

• Pomocí vícedílných požadavků můžete přidat objekty blob do entit služby Azure Digital Twins.

• Další informace o ověřování pomocí rozhraní API pro správu najdete v tématu Ověřování pomocí rozhraní API.