API-átjáró létrehozása
A cégeknek gyakran kell megoldást találniuk arra, hogy elérhetővé tudják tenni az adataikat a partnereik számára. Ezt a hozzáférést irányítani és felügyelni kell.
A cipőket forgalmazó vállalat példájánál maradva, a NorthWind Shoes által forgalmazott cipőket készleten tartó kiskereskedőknek tudniuk kell, hogy mennyi készletet rendelhetnek. Az ügyfelek azt is szeretnék tudni, hogy pontosan mikor kapják meg a rendelésüket.
Itt megtudhatja, hogyan működik az Azure API Management, és hogyan állíthat be EGY API-átjárót.
Azure API Management
Az Azure API felügyeleti szolgáltatás az Azure-felhőben üzemel, és az API-k és az internet között helyezkedik el. Az API Management-példány Azure API-átjáróként működik.
Az API-k közzétételekor az Azure Portalon szabhatja meg, hogyan érhetik el a fogyasztók az adott API-kat. Előfordulhat például, hogy egyes API-kat szabadon elérhetővé szeretne tenni a fejlesztők számára vagy bemutatási célra, míg más API-k hozzáférését szigorúan kézben szeretné tartani.
Miért érdemes az API Managementet használni?
A fejlesztők számára az API Management használata számos előnnyel jár.
- API-dokumentáció. Az API-k dokumentációjának köszönhetően a hívó ügyfelek megoldásai gyorsan integrálhatók. Az API Management lehetővé teszi, hogy gyorsan elérhetővé tegye az API struktúráját az ügyfelek meghívásához olyan modern szabványokon keresztül, mint az OpenAPI. Egy API több verziójával is rendelkezhet. Ha több verziója van, ütemezheti az alkalmazásfrissítéseket, mert az alkalmazásoknak nem kell azonnal az új verziót használniuk.
- Sebességkorlátozó hozzáférés. Ha egy API nagy mennyiségű adathoz férhet hozzá, akkor érdemes korlátozni a sebességet, amellyel az ügyfelek adatokat kérdezhetnek le. A sebességkorlátozás segít fenntartani az optimális válaszidőt minden ügyfél számára. Az API Management lehetővé teszi a sebességkorlátok egészének vagy adott egyedi ügyfeleknek a beállítását.
- Állapotfigyelés. A távoli ügyfelek felhasználják az API-kat, így nehéz lehet azonosítani a lehetséges problémákat vagy hibákat. Az API Managementtel megtekintheti a hibaüzeneteket és a naplófájlokat, amelyeket választípusok alapján szűrhet.
- Modern formátumok, például JSON. Az API-k az évek során számos különböző adatcsere-formátumot használtak az XML-től egészen a CSV-ig. Az API Management lehetővé teszi, hogy ezeket a formátumokat modern adatmodellekkel, például JSON-nal tegye elérhetővé.
- Csatlakozás bármilyen API-hoz. Számos vállalkozásban az API-k különböző országokban/régiókban találhatók, és különböző formátumokat használnak. Az API Management lehetővé teszi, hogy ezeket a különálló API-kat egyetlen modern felületen adja hozzá.
- Elemzés. Az API-k fejlesztésekor hasznos, ha nyomon tudja követni, hogy milyen gyakran és milyen típusú rendszerek hívják az API-kat. Az API Management lehetővé teszi ezen adatok vizualizációját az Azure Portalon.
- Biztonság. A rendszeradatok kezelésekor a biztonság létfontosságú tényező. A jogosulatlan hozzáférések költségekkel, a kód újraírására elvesztegetett idővel és azzal járhatnak, hogy csorbul a vállalat jó híre. Az Azure API-kezeléssel használható biztonsági eszközök közé tartozik az OAuth 2.0 felhasználói engedélyezése, valamint a Microsoft Entra ID-val való integráció.
- Tarifacsomagok. Az API Management különböző képességekkel rendelkezik a kérések átviteli sebességéhez, az SLA-hoz, a hálózatelkülönítéshez, a frissítési rugalmassághoz stb. Az Azure API felügyeleti átjáró létrehozásakor kiválaszthatja az igényeinek megfelelő szintet.
Az API Management beállítása
Az API Management beállításához a következőket kell elvégeznie:
- API Management-átjáró létrehozása. Az átjáró neve az .azure-api.net névtéren belül csak egyszer szerepelhet.
- Meglévő webes API regisztrálása az átjáróval. A regisztrálással az API elérhetővé válik a fogyasztók számára az <átjáró>.azure-api.net végponton.
- Hívja meg a meglévő API-t az átjárón keresztül. A felhasználók mostantól meghívhatják az API-t a végpont URL-címén.