宣佈推出 REST API 體驗的更新
此文章是由 docs.microsoft.com 小組的 Jessie 一位專案經理 Jessie 一文所撰寫。
今天,我們很高興宣佈在 docs.microsoft.com上發行 REST 體驗的兩個主要改善:
- REST API Browser的預覽版本,這是搜尋及探索 Microsoft 開發的 REST API 的簡單方式。
- REST 試用--互動式體驗,可讓您直接在慣用的網頁瀏覽器中試用 REST API。
在一個位置探索 REST API
如果您已經熟悉我們任何現有的 API 瀏覽器體驗,例如 適用于 .NET、 PowerShell、 Python 或 JavaScript,您會覺得很適合這個新版本, 它可讓您快速取得各種 REST API 的檔,而不需要依賴較不專注的搜尋體驗。 API 瀏覽器是透過在幾秒內尋找正確的 API,快速讓您快速上手。
先前,如果您想要在 docs.microsoft.com上尋找特定的 REST API 檔,您可能必須透過整個網站搜尋尋找它,或使用內容頁面上的任何導覽元件,例如目錄。 這可能很耗時,特別是在您確切知道要尋找的專案的情況下。 我們想要讓這更容易。
從今天開始,您可以從一個集中式位置以更有效率的方式探索 Microsoft REST API - https://docs.microsoft.com/rest/api 。 只要從下拉式清單中選取服務,即可尋找所有可用的服務 API:
需要儲存點選嗎? 對於一些最常使用的 API,您隨時可以計入 [快速篩選 ] - 按一下其中一個 API,即可立即為指定的服務顯示一組完整的 API,以取得其最新版本:
我們設計了搜尋體驗的方式,可讓您尋找必要的 API 資訊,不論您知道確切的關鍵字,還是即使您不知道服務, 也一樣! 根據預設,我們會搜尋記載于 docs.microsoft.com的所有 API。 只有在選取服務時,搜尋才會在該服務的範圍內發生。
需要一次搜尋多個關鍵字嗎? 您也可以這麼做!
在瀏覽器中試用 Azure REST API
找到感興趣的 Azure API,但不知道它是否相當需要協助您建置案例? 別擔心,因為從今天開始,您可以在瀏覽器中直接試用 Azure REST API,docs.microsoft.com!
您只需要按綠色的 [試用] 按鈕:
選取 [ 試用 REST API] 之後,系統會將您帶至焦點檢視,讓您試驗不同的參數值或要求本文。 您可以使用頁面左上角的 [內容 ] 漢堡功能表,輕鬆地變更文章內容:
我們希望您的意見反應
我們打算在短期內實作許多改善,因此此體驗並非最後一項,例如,我們不僅會針對 Azure REST API 啟用試用。 我們希望您告訴我們如何讓 REST 體驗變得更好 - 只要 開啟新的問題,我們就會儘快回到您。
您也可以跟隨我們的 Twitter 帳戶,掌握最新的消息和通知!
夢想有更美好的開發人員世界嗎? 加入我們的小組!