API 曾經主要服務基于文本的資料，現在它們幾乎是每個行業和技術層面的各種SaaS產品背后的引擎，現在生產和使用 API 的方式甚至比五年前還要復雜，但是 API 檔案呢？
過去，提供端點串列和一些關于授權令牌的指導足以讓開發人員開始使用 API，但隨著 API 產品和用例變得越來越復雜，基本的描述性檔案是不夠的，更新檔案聽起來像是一個重大專案，但現在投資一種可持續的方法可以讓團隊花在手動更改上的時間以及為用戶提供良好體驗上獲得巨大的回報，
現代化 API 檔案意味著結合三個要素：自動化、可重用性和互動性，讓我們深入研究下面的每一個，以便你可以了解API檔案的發展趨勢，
自動化檔案以跟上開發團隊
設計優先的 API 方法非常適合想要頻繁且高效地迭代的 API 團隊，縮短 API 更新的發布時間表可為用戶創造價值，并使你能夠快速適應新的需求，快速迭代的缺點是，沒有人希望放慢發布速度來記錄每一個更改，
API維護人員需要時刻記住他們的用戶，但快速迭代有點像一把雙刃劍，一方面，你希望讓開發團隊騰出時間去做他們最擅長的事情，而不是陷入檔案程式中，同時，如果 API 消費者沒有一種簡單的方法來了解并親自嘗試API，那么所有這些了不起的創新都將毫無用處，
自動化檔案是一個很好的一線解決方案，它可以以一種精確映射到API端點的格式進行檔案記錄，最基本的自動化檔案可以圍繞OpenAPI規范構建的開源工具生成，這些工具通過讀取你的 OpenAPI 規范檔案并將該資料直接輸入互動式網路工具來作業，它們啟動速度很快，并且會在你的 OpenAPI 規范檔案更改時自動更新，
為一致、靈活的檔案創建可重用模塊
最好的檔案不僅僅是提供資訊，它還具有教育意義和啟發意義，我們上面討論的參考檔案是必要的，但它們不太可能激發你的 API 消費者的創造力或鼓勵他們深入挖掘，
為了使你的檔案能夠實作這些崇高目標，它需要嵌入到你的開發人員體驗中，使用你的產品的開發人員應該經常遇到示例、指南和代碼示例，而不僅僅是在他們尋找它們時，查看更多關于你的 API 的實際使用檔案有助于開發人員設想新的集成并加深他們與你的產品的互動，
再一次，你可能會認為這意味著你的團隊需要做更多的作業，優秀檔案的另一個關鍵特征是一致性，其提供了一些護欄來幫助保持作業的可管理性，開發人員使用模塊化代碼來確保應用程式按預期運行，模塊化、可重用的檔案有助于實作相同的目標，
實作相同目標的另一種方法是使用內容標記和過濾，重復的檔案讓用戶和維護者頭疼，但隨著檔案范圍的擴大，避免重復檔案可能具有挑戰性，最終目標與可重用模塊相同，一次創建高質量的檔案，并使它們易于查找和重用，
使用互動式檔案引導和吸引你的 API 使用者
在某些時候，決定開始使用你的 API 構建的開發人員將需要一個地方來測驗和獲取結果， 一些測驗類的工具很受歡迎，它們幫助開發人員使用你的 API ，但仍然需要他們在你的檔案和第三方工具之間來回切換，并且不會為你提供深入了解他們最初的開發人員經驗，
作為檔案的一部分提供互動式功能是滿足開發人員需求并加強他們與你的產品的聯系的一種方式，第三方工具需要開發者通過JSON做大量的篩選結果和梳理，你自己構建的功能可以集中在與用戶所在檔案部分最相關的內容上，你還可以提醒用戶注意那些讓用戶困惑的問題，比如提供一個工具來探索標題，或者通過互動式演示突出令牌和秘密的最佳實踐，
為開發人員提供選項，讓他們可以繞過第三方工具，這樣你就可以縮小范圍，并將用戶的注意力集中在API最重要的功能和需求上，當你讓用戶直接在你的檔案中測驗請求和回應時，你會吸引他們的注意力并縮短他們的啟動時間，
檔案的目的是讓人們成功使用你的 API，提供端點的詳細事實記錄很重要，但如果你的目標是推動新的集成，這還不夠，及時了解 API 檔案的最新進展，創建一致、可重復使用的互動式檔案，將改善你的開發人員體驗，考慮使用API生命周期管理以更快地實作目標，教育和激勵你的用戶，
新年將至，我們也準備了一批紅包封面作為福利來送給大家！使用的是兌換碼形式：xhVS4wKnIxT，兌換流程如下：
沒搶到也不要緊，除了日常的文章發布，接下來還有每天定時領~詳細如下圖！
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/421347.html
標籤：其他