A REST API-használat frissítéseinek bejelentése
Ezt a bejegyzést Jessie Huang, a docs.microsoft.com csapat programmenedzsere írta.
Ma örömmel jelentjük be a REST-élmény két fő továbbfejlesztésének kiadását a docs.microsoft.com:
- A REST API Browser előzetes verziója – a Microsoft által fejlesztett REST API-k keresésének és felderítésének egyszerű módja.
- REST Try It – interaktív felület, amely lehetővé teszi a REST API-k kipróbálását közvetlenül a kedvenc webböngészőjében.
REST API-k felderítése egy helyen
Ha már ismeri bármelyik meglévő API Browser-felületünket, például a .NET, a PowerShell, a Python vagy a JavaScript használatát, akkor otthon érezheti magát ezzel az új kiadással – így gyorsan lekérheti a rest API-k széles körének dokumentációját anélkül, hogy kevésbé koncentrált keresési élményre kellene támaszkodnia. Az API Browser a megfelelő API másodpercek alatt történő megkereséséről szól.
Korábban, ha konkrét REST API-dokumentációt keresett a docs.microsoft.com, előfordulhat, hogy az egész webhelyre kiterjedő kereséssel kellett keresnie, vagy a tartalomoldalakon, például a tartalomjegyzékben használt navigációs összetevőket kellett használnia. Ez időigényes lehet, különösen olyan helyzetekben, amikor pontosan tudja, mit keres. Azt akartuk, hogy könnyebb legyen.
A mai naptól kezdve sokkal hatékonyabb módon fedezheti fel a Microsoft REST API-kat egy központosított helyről – https://docs.microsoft.com/rest/api. Egyszerűen válasszon ki egy szolgáltatást a legördülő listából az összes elérhető szolgáltatás API megkereséséhez:
Mentenie kell egy kattintást? A leggyakrabban használt API-k némelyikéhez mindig számíthat a gyorsszűrőkre – az egyikre kattintva azonnal megjelenik egy adott szolgáltatás api-jainak átfogó készlete a legújabb kiadásához:
Úgy alakítottuk ki a keresési felületet, hogy lehetővé tegyük a szükséges API-információk megtalálását, függetlenül attól, hogy pontosan ismeri-e a kulcsszavakat vagy sem – vagy még akkor is, ha nem ismeri azt a szolgáltatást, amelyben van! Alapértelmezés szerint az docs.microsoft.com dokumentált összes API-ban keresünk. A keresés csak akkor történik meg, ha egy szolgáltatás van kiválasztva.
Egyszerre több kulcsszót kell keresnie? Ezt is megteheti!
Az Azure REST API-k kipróbálás a böngészőben
Talált egy érdekes Azure API-t, de nem tudja, hogy pontosan mire van szüksége a forgatókönyv összeállításához? Ne aggódjon, mert a mai naptól kezdve kipróbálhatja az Azure REST API-kat közvetlenül a böngészőben, docs.microsoft.com!
Mindössze annyit kell tennie, hogy lenyomja a zöld Try It gombot:
Ha a Kipróbálás REST API-hoz lehetőséget választja, a rendszer egy szűrt nézetbe helyezi, ahol különböző paraméterértékekkel vagy kéréstörzsgel kísérletezhet. A cikk kontextusát ugyanúgy módosíthatja a lap bal felső sarkában található Tartalom hamburger menü használatával:
Visszajelzést kérünk
A közeljövőben számos fejlesztést tervezünk megvalósítani, ezért ez a felület egyáltalán nem végleges, például a Kipróbálás nem csak az Azure REST API-k esetében lesz engedélyezve. Szeretnénk, ha elmondaná nekünk, hogyan javíthatjuk a REST-élményt – csak nyisson meg egy új problémát, és mihamarabb visszatérünk Önhöz.
Kövessen minket a Twitteren, ahol értesülhet a legújabb hírekről és értesítésekről.
Azon szeretne dolgozni, hogy megkönnyítse a fejlesztők munkáját? Csatlakozzon a csapatunkhoz!