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.

Tip

Týmy rozhraní API můžou tuto funkci používat v pracovních prostorech. Pracovní prostory poskytují izolovaný administrativní přístup k rozhraním API a jejich vlastním prostředím pro spuštění 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:

• Import rozhraní API do služby API Management
• Testovat rozhraní API na portálu Azure Portal

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 portálu Azure 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 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 o produktech naleznete v části Vytvoření a publikování produktu.
   Brány	Spravované	Brány API, které je zpřístupňují. 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. Samohostované brány 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é.
   Verzovat toto rozhraní API?	Vybrat nebo zrušit výběr	Další informace najdete v tématu Publikování více verzí rozhraní API.

5. Výběrem 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í. V testovací konzole portálu se ve výchozím nastavení volá API pomocí klíče z integrovaného předplatného pro plný přístup. Volání rozhraní API můžete testovat také pomocí klíče předplatného vztahujícího se k produktu.

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 stavparametr dotazu. 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.

   

   Server odpovídá s 200 OK a poskytuje některá data.

Další kroky

V tomto kurzu jste se naučili, jak:

• Importovat vaše první rozhraní API
• Testovat rozhraní API na portálu Azure Portal

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

Vytvoření a publikování produktu