宣佈推出 REST API 體驗的更新

此文章是由 docs.microsoft.com 小組的 Jessie 一位專案經理 Jessie 一文所撰寫。

今天,我們很高興宣佈在 docs.microsoft.com上發行 REST 體驗的兩個主要改善:

  • REST API Browser的預覽版本,這是搜尋及探索 Microsoft 開發的 REST API 的簡單方式。
  • REST 試用--互動式體驗,可讓您直接在慣用的網頁瀏覽器中試用 REST API。

在一個位置探索 REST API

如果您已經熟悉我們任何現有的 API 瀏覽器體驗,例如 適用于 .NETPowerShellPythonJavaScript,您會覺得很適合這個新版本, 它可讓您快速取得各種 REST API 的檔,而不需要依賴較不專注的搜尋體驗。 API 瀏覽器是透過在幾秒內尋找正確的 API,快速讓您快速上手。

先前,如果您想要在 docs.microsoft.com上尋找特定的 REST API 檔,您可能必須透過整個網站搜尋尋找它,或使用內容頁面上的任何導覽元件,例如目錄。 這可能很耗時,特別是在您確切知道要尋找的專案的情況下。 我們想要讓這更容易。

從今天開始,您可以從一個集中式位置以更有效率的方式探索 Microsoft REST API - https://docs.microsoft.com/rest/api 。 只要從下拉式清單中選取服務,即可尋找所有可用的服務 API:

選取產品以探索 REST API

需要儲存點選嗎? 對於一些最常使用的 API,您隨時可以計入 [快速篩選 ] - 按一下其中一個 API,即可立即為指定的服務顯示一組完整的 API,以取得其最新版本:

透過頁面內快速篩選探索 REST API

我們設計了搜尋體驗的方式,可讓您尋找必要的 API 資訊,不論您知道確切的關鍵字,還是即使您不知道服務, 也一樣! 根據預設,我們會搜尋記載于 docs.microsoft.com的所有 API。 只有在選取服務時,搜尋才會在該服務的範圍內發生。

依單一關鍵字搜尋 REST API

需要一次搜尋多個關鍵字嗎? 您也可以這麼做!

依多個關鍵字搜尋 REST API

在瀏覽器中試用 Azure REST API

找到感興趣的 Azure API,但不知道它是否相當需要協助您建置案例? 別擔心,因為從今天開始,您可以在瀏覽器中直接試用 Azure REST API,docs.microsoft.com!

您只需要按綠色的 [試用] 按鈕:

REST 試用 - 啟動體驗

選取 [ 試用 REST API] 之後,系統會將您帶至焦點檢視,讓您試驗不同的參數值或要求本文。 您可以使用頁面左上角的 [內容 ] 漢堡功能表,輕鬆地變更文章內容:

REST 試用 - 變更文章內容

我們希望您的意見反應

我們打算在短期內實作許多改善,因此此體驗並非最後一項,例如,我們不僅會針對 Azure REST API 啟用試用。 我們希望您告訴我們如何讓 REST 體驗變得更好 - 只要 開啟新的問題,我們就會儘快回到您。

您也可以跟隨我們的 Twitter 帳戶,掌握最新的消息和通知!

夢想有更美好的開發人員世界嗎? 加入我們的小組