Kurz: Import a publikování prvního rozhraní API

PLATÍ PRO: Všechny úrovně služby API Management

V tomto kurzu se dozvíte, jak importovat back-endové rozhraní API specifikace OpenAPI ve formátu JSON do služby Azure API Management. V tomto příkladu importujete opensourcové rozhraní PETstore API.

Po importu rozhraní API back-endu do služby API Management se rozhraní API služby API Management stane adaptační vrstvou pro rozhraní API back-endu. Adaptační vrstvu si můžete přizpůsobit svým potřebám ve službě API Management bez nutnosti zasahovat do rozhraní API back-endu. Další informace najdete v tématu Transformace a ochrana vašeho rozhraní API.

V tomto kurzu se naučíte:

Po importu můžete rozhraní API spravovat na webu Azure Portal.

Požadavky

• Seznamte se s terminologií služby Azure API Management.
• Vytvořte instanci služby Azure API Management.

Přejít k instanci služby API Management

1. Na webu Azure Portal vyhledejte a vyberte služby API Management.

   

2. Na stránce služby API Management vyberte instanci služby API Management.

   

Import a publikování back-endového rozhraní API

Tato část ukazuje, jak importovat a publikovat back-endové rozhraní API specifikace OpenAPI.

1. V levém navigačním panelu instance služby API Management vyberte rozhraní API.

2. Vyberte dlaždici OpenAPI .

3. V okně Vytvořit ze specifikace OpenAPI vyberte Úplné.

4. Zadejte hodnoty z následující tabulky.

   Hodnoty rozhraní API můžete nastavit během vytváření nebo později tak, že přejdete na kartu Nastavení .

   

   Nastavení	Hodnota	Popis
   Specifikace OpenAPI	https://petstore3.swagger.io/api/v3/openapi.json	Určuje back-endovou službu, která implementuje rozhraní API, a operace, které rozhraní API podporuje. Adresa URL back-endové služby se později zobrazí jako adresa URL webové služby na stránce Nastavení rozhraní API. Po importu můžete do specifikace přidat, upravit, přejmenovat nebo odstranit operace.
   Zahrnutí parametrů dotazu do šablon operací	Vybráno (výchozí)	Určuje, jestli se mají ve službě API Management importovat požadované parametry dotazu ve specifikaci jako parametry šablony.
   Zobrazované jméno	Jakmile zadáte adresu URL specifikace OpenAPI, služba API Management toto pole vyplní na základě kódu JSON.	Název zobrazený na portálu pro vývojáře
   Název	Jakmile zadáte adresu URL specifikace OpenAPI, služba API Management toto pole vyplní na základě kódu JSON.	Jedinečný název rozhraní API.
   Popis	Jakmile zadáte adresu URL specifikace OpenAPI, služba API Management toto pole vyplní na základě kódu JSON.	Volitelný popis rozhraní API.
   Schéma URL	HTTPS	Které protokoly mají přístup k rozhraní API.
   Přípona adresy URL rozhraní API	petstore	Přípona připojená k základní adrese URL služby API Management. Služba API Management rozlišuje rozhraní API podle jejich přípony, takže přípona musí být jedinečná pro každé rozhraní API daného vydavatele.
   Značky		Značky pro uspořádání rozhraní API pro vyhledávání, seskupování nebo filtrování
   Produkty	Unlimited	Přidružení jednoho nebo více rozhraní API V určitých úrovních má instance SLUŽBY API Management dva ukázkové produkty: Starter a Unlimited. Rozhraní API publikujete na portálu pro vývojáře tím, že rozhraní API přidružujete k produktu. Do produktu můžete zahrnout několik rozhraní API a nabízet vývojářům předplatná produktů prostřednictvím portálu pro vývojáře. Pokud chcete toto rozhraní API přidat do jiného produktu, zadejte nebo vyberte název produktu. Opakováním tohoto kroku přidejte rozhraní API do více produktů. Rozhraní API můžete do produktů přidat také později na stránce Nastavení . Další informace oproduktch
   Brány	Spravované	Brány rozhraní API, které zpřístupňují rozhraní API. Toto pole je k dispozici pouze ve službách úrovně Developer a Premium . Spravovaná označuje bránu integrovanou do služby API Management a hostované Microsoftem v Azure. Brány v místním prostředí jsou dostupné jenom na úrovních služeb Premium a Developer. Můžete je nasadit místně nebo v jiných cloudech. Pokud nejsou vybrány žádné brány, rozhraní API nebude k dispozici a vaše požadavky rozhraní API nebudou úspěšné.
   Chcete toto rozhraní API ve verzi?	Výběr nebo zrušení výběru	Další informace najdete v tématu Publikování více verzí rozhraní API.

5. Výběrem možnosti Vytvořit vytvořte rozhraní API.

Pokud máte problémy s importem definice rozhraní API, prohlédněte si seznam známých problémů a omezení.

Testování nového rozhraní API na webu Azure Portal

Operace rozhraní API můžete volat přímo z webu Azure Portal, což poskytuje pohodlný způsob zobrazení a testování operací. Ve výchozím nastavení se v testovací konzole portálu volají rozhraní API pomocí klíče z integrovaného předplatného pro přístup. Volání rozhraní API můžete testovat také pomocí klíče předplatného omezeného na produkt.

1. V levém navigačním panelu vaší instance služby API Management vyberte rozhraní API>Swagger Petstore.

2. Vyberte kartu Test a pak vyberte Najít domácí zvířata podle stavu. Na stránce se zobrazuje parametr dotazu stavu. Vyberte jednu z dostupných hodnot, například čekající na vyřízení. Tady můžete také přidat parametry dotazu a hlavičky.

   V části požadavku HTTP se automaticky vyplní hlavička Ocp-Apim-Subscription-Key, která se zobrazí, pokud vyberete ikonu oka.

3. Vyberte Odeslat.

   

   Back-end reaguje na 200 OK a některá data.

Další kroky

V tomto kurzu jste se naučili, jak:

V dalším kurzu se dozvíte, jak vytvořit a publikovat produkt: