Oznamujeme aktualizace možností rozhraní REST API

Tento příspěvek napsal Jessie Huang, programový manažer v týmu docs.microsoft.com.

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

  • Verze Preview prohlížeče REST API – snadný způsob, jak vyhledávat a objevovat rozhraní REST API vyvinutá Microsoftem.
  • Rest Try It --an interactive experience to you try you to try REST API přímo ve svém oblíbeném webovém prohlížeči.

Zjišťování rozhraní REST API v jednom umístění

Pokud už znáte některé z našich stávajících prostředí prohlížeče rozhraní API, jako je rozhraní .NET, PowerShell, Python nebo JavaScript, budete se cítit přímo doma s touto novou verzí – umožňuje rychle získat dokumentaci pro širokou škálu rozhraní REST API, aniž byste 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.

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í v rámci celého webu nebo použít některou z navigačních komponent na stránkách obsahu, jako je 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 zjistit rozhraní MICROSOFT REST API mnohem efektivnějším způsobem 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:

Discover REST APIs by selecting products

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

Discover REST APIs via in-page quick filter

Navrhli jsme vyhledávací prostředí způsobem, který vám umožní najít potřebné informace rozhraní API bez ohledu na to, jestli znáte přesná klíčová slova nebo ne , nebo i když neznáte službu, ve které je. Ve výchozím nastavení prohledáme všechna rozhraní API zdokumentovaná na docs.microsoft.com. Hledání proběhne pouze v případě, že je vybraná služba, bude hledání probíhat v rámci oboru této služby.

Searching REST APIs by a single keyword

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

Searching REST APIs by multiple keywords

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

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

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

REST Try It - Launching the experience

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

REST Try It - Changing the article context

Chceme váš názor

V blízké době plánujeme implementaci mnoha vylepšení, takže toto prostředí není žádným způsobem konečné, například pro rozhraní Azure REST API ji povolíme. Chceme, abyste nám řekli, jak můžeme zlepšit naše prostředí REST – stačí otevřít nový problém a co nejdříve se k vám vrátíme.

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!