Oznamujeme aktualizace možností rozhraní REST API

  • Článek

Tento příspěvek napsala Jessie Huangová, programová manažerka docs.microsoft.com týmu.

Dnes s radostí oznamujeme vydání dvou klíčových vylepšení prostředí REST na docs.microsoft.com:

  • Verze Preview prohlížeče rozhraní REST API – snadný způsob, jak vyhledávat a objevovat rozhraní REST API vyvinutá Microsoftem.
  • Vyzkoušejte rest – interaktivní prostředí, které vám umožní vyzkoušet rozhraní REST API přímo ve vašem oblíbeném webovém prohlížeči.

Zjišťování rozhraní REST API na jednom místě

Pokud už jste obeznámeni s některým z našich stávajících rozhraní API Browser, například s rozhraním .NET, PowerShellem, Pythonem nebo JavaScriptem, budete se s touto novou verzí cítit jako doma – umožní vám rychle získat dokumentaci pro širokou škálu rozhraní REST API, aniž byste se museli spoléhat na méně zaměřené vyhledávání. Prohlížeč rozhraní API vám umožňuje rychle najít správné rozhraní API během několika sekund.

Vyzkoušejte prohlížeč rozhraní REST API

Pokud jste dříve chtěli najít konkrétní dokumentaci k rozhraní REST API na docs.microsoft.com, možná jste ji museli vyhledat prostřednictvím našeho vyhledávání na celém webu nebo použít některou z navigačních komponent na stránkách obsahu, například obsah. To může být časově náročné, zejména v situacích, kdy přesně víte, co hledáte. Chtěli jsme to usnadnit.

Od dnešního dne můžete rozhraní Microsoft REST API objevovat mnohem efektivněji, a to z jednoho centralizovaného umístění – https://docs.microsoft.com/rest/api. Jednoduše vyberte službu z rozevíracího seznamu a vyhledejte všechna dostupná rozhraní API služby:

Zjišťování rozhraní REST API výběrem produktů

Potřebujete uložit kliknutí? U některých z nejčastěji používaných rozhraní API se můžete vždy spolehnout na rychlé filtry – kliknutím na jedno z nich okamžitě zobrazíte komplexní sadu rozhraní API pro danou službu pro její nejnovější verzi:

Zjišťování rozhraní REST API pomocí rychlého filtru na stránce

Prostředí vyhledávání jsme navrhli tak, abyste mohli najít potřebné informace rozhraní API bez ohledu na to, jestli znáte přesná klíčová slova, nebo i když neznáte službu, ve které se nachází. Ve výchozím nastavení prohledáme všechna rozhraní API zdokumentovaná na docs.microsoft.com. Pouze v případě, že je vybrána služba, bude vyhledávání probíhat v rámci oboru této služby.

Vyhledávání rozhraní REST API podle jednoho klíčového slova

Potřebujete vyhledat více klíčových slov najednou? Můžete to udělat i vy!

Vyhledávání rozhraní REST API podle více klíčových slov

Vyzkoušejte rozhraní Azure REST API v prohlížeči

Našli jste rozhraní API Azure, které vás zajímá, ale nevíte, jestli je to přesně to, co potřebujete k vytvoření scénáře? Nebojte se, protože od dnešního dne můžete rozhraní Azure REST API vyzkoušet přímo v prohlížeči na docs.microsoft.com!

Vyzkoušejte interaktivní rozhraní Azure REST API

Stačí stisknout zelené tlačítko Vyzkoušet :

Rest Try It – Spuštění prostředí

Jakmile pro rozhraní REST API vyberete Vyzkoušet , přejdete do prioritního zobrazení, které vám umožní experimentovat s různými hodnotami parametrů nebo textem požadavku. Stejně snadno můžete změnit kontext článku pomocí hamburgerové nabídky Obsah v levém horním rohu stránky:

Rest Try It – Změna kontextu článku

Chceme vaši zpětnou vazbu

V blízké době plánujeme implementovat řadu vylepšení, takže toto prostředí není v žádném případě konečné, například povolíme možnost Vyzkoušet nejen pro rozhraní Azure REST API. Chceme, abyste nám řekli, jak můžeme prostředí REST vylepšit – stačí otevřít nový problém a my se vám co nejdříve ozvěte.

A nezapomeňte sledovat nejaktuálnější informace a oznámení na našem twitterovém účtu!

Sníte o tom, že zlepšíte svět pro vývojáře? Připojte se k našemu týmu!