騰訊云API文檔簡潔之美，只需三步開啟

API最初出現(xiàn)時通常被用作操作系統(tǒng)的庫，而且?guī)缀醵荚诒镜氐南到y(tǒng)中運行。到2000年代初，它們已脫離本地運行環(huán)境，成為遠程交互數(shù)據(jù)的重要技術。現(xiàn)如今，API不僅僅是一種技術連接，也成為了一種商業(yè)連接。通過開放API，個人或者企業(yè)可以打開自由之門，向客戶、合作伙伴提供數(shù)字化產(chǎn)品和服務。API網(wǎng)關作為管理API的平臺，也在朝著為API開發(fā)者提供更豐富、完整的服務方向前進。近期，騰訊云API網(wǎng)關在現(xiàn)有API全生命周期管理能力基礎上，聯(lián)合CODING API文檔產(chǎn)品團隊，為開發(fā)者提供了API文檔生成工具，基于這個工具開發(fā)者可以按需發(fā)布API文檔。

騰訊云API網(wǎng)關（以下簡稱API網(wǎng)關）是騰訊云Severless團隊推出的API托管服務，能提供API的完整生命周期管理，包括創(chuàng)建、維護、發(fā)布、運行、下線等。您可使用API網(wǎng)關封裝自身業(yè)務，將您的數(shù)據(jù)、業(yè)務邏輯或功能安全可靠的開放出來，用以實現(xiàn)自身系統(tǒng)集成、以及與合作伙伴的業(yè)務連接。

精準簡潔的API文檔可以降低API協(xié)作的復雜度，給予API使用者更直觀的API信息，簡化并加速API集成過程。例如在常見的前后端開發(fā)協(xié)作場景中，通過一份接口文檔，就可以實現(xiàn)前后端并行開發(fā)：后臺開發(fā)者把API托管在API網(wǎng)關上，配好mock server，利用API文檔功能把API信息提供給前端同學，來實現(xiàn)前后端分離。API文檔可以解決的問題不僅僅于此：

·如果你把API當做接口，那么你需要讓使用方知道該如何對接這個系統(tǒng)，那么你的API文檔就是你提供的詳細說明書。

·如果你把API當作契約，那么你需要讓合作方詳細了解你們之間的規(guī)則，你的API文檔就是各方之間的完整協(xié)議。

·如果你把API當作商品，那么你需要讓你的客戶知道可以按什么方式下單，你的API文檔就是你提供的精美菜單。

現(xiàn)在，在騰訊云API網(wǎng)關控制臺，只用三步就可快速發(fā)布您的API文檔。

三步開啟簡潔API文檔

步驟1：在您登錄「騰訊云API網(wǎng)關控制臺」后，在工具一欄選擇「API文檔」，就可以針對你現(xiàn)有的API創(chuàng)建對應文檔。

選擇好您要發(fā)布的API，剩下的都交給CODING API文檔與API網(wǎng)關。

步驟2：喝上幾口熱水的功夫，就可以看到自動構建完畢的API文檔鏈接，你可以隨時隨地將這個鏈接和口令分享給你的協(xié)作者。

步驟3：拿到鏈接與口令后，你的協(xié)作者就可以在瀏覽器中看到清晰、簡潔、規(guī)范的API文檔。三欄的經(jīng)典文檔格式，同時展示API列表、API詳情與調用范例，更符合開發(fā)者閱讀習慣。適當?shù)念伾吡僚c恰到好處的間距用來展示每個API的詳細調用說明：包括URL、Request、Response等等信息。一旦API接口內容發(fā)生改變（雖然API不常變），只要在API文檔工具里點擊「更新」，不變的API文檔地址，最新的API文檔內容。

好用怎么就不能好看？

對于開發(fā)者，從一行代碼，到一個函數(shù)，再到一個應用程序、一個API文檔或者一篇技術博客，這些工作成果都是你或者你所在團隊的名片，我們希望你的工作成果不僅高效還體面。CODING開發(fā)團隊深耕API協(xié)作方式多年，帶來了令人賞心悅目的API文檔，只為帶來沉浸的閱讀體驗。API文檔工具現(xiàn)已在騰訊云API網(wǎng)關正式上線并免費開放，API網(wǎng)關用戶可以立即擁有全新的API文檔。

關于CODING

對于API文檔功能有更加多樣化需求的用戶，可以選擇登錄CODING使用更加全面的API文檔管理功能，包括支持OpenAPI/Postman/Apidoc API描述格式導入文檔、自由選擇開放文檔方式等等，開始有序的API文檔協(xié)作。不僅僅是API文檔，致力于“讓開發(fā)更簡單”的CODING，提供了從代碼托管、項目協(xié)同、持續(xù)集成、制品庫、持續(xù)部署、文件管理/Wiki等的一站式研發(fā)協(xié)作工具。