国内精品久久久久久久,在线免费观看日本高清,亚洲国产视频久久

高達55%的調查受訪者使用OpenAPI版本，而RAML和API藍圖為7%。

為什么OpenAPI贏得了戰爭？

OpenAPI（當時名為Swagger）首先上市，但還有其他一些關鍵因素有助于通過口碑迅速傳播：

開源生態系統：Swagger、RAML和API Blueprint都是開源項目。然而，Swagger吹捧了開源工具、代碼生成和客戶端SDK的豐富生態系統，使社區能夠更有機地增長。API社區仍然可以通過為圍繞標準的開源軟件做出貢獻來支持Swagger，即使他們沒有直接為開源標準本身做出貢獻。相比之下，工具提供商是RAML和API藍圖格式提供商的競爭對手，這使得他們對支持競爭對手的格式猶豫不決。
工具不可知論者：Swagger在一家API公司Wordnik孵化，因此標準是工具不可知論者。相比之下，RAML和API藍圖是由API工具開發的，這意味著RAML和API藍圖的早期用戶需要考慮未來的供應商鎖定。

OpenAPI是更好的格式嗎？

毫無疑問，OpenAPI是使用最廣泛的標準。然而，RAML和API藍圖都解決了合法問題，通常以更有針對性的方式。

例如，考慮OAS和RAML之間的差異。2017年，MuleSoft表示：“RAML已成為建模API規范的主要方式，[OpenAPI]已成為描述API的最常見格式。”

使用這些術語時有相似之處和模糊之處。如果我們要求ChatGPT告訴我們“建模”和“描述”API之間的區別，它告訴我們，“API建模是指設計和定義API結構的過程，包括其端點、請求/響應格式和錯誤處理。它涉及創建API功能和行為的藍圖。另一方面，API描述是指記錄API的行為，包括其目的、使用和參考信息，如可用的端點、請求/響應格式、身份驗證方法和錯誤代碼。API描述的目的是為開發人員提供有效使用API所需的所有信息。”

總之，API建模是關于設計API，而API描述是關于記錄它。

ChatGPT，由OpenAI開發的聊天機器人

換句話說，開發 RAML 是為了對 API 進行建模和設計，而開發 Swagger 是為了描述和記錄 API。在 API 生命周期的初期，當 API 生產者決定 API 應該是什么時，他們可能會傾向于使用 RAML。API 生產者可能會在設計完成后生成 Swagger 文件，以增強 API 消費者的開發體驗。無論意圖如何，這兩種格式都可用于在整個 API 生命周期中對 API 進行建模或描述。

事實上，隨著 OpenAPI 的廣泛應用，API 生產者現在使用這種格式來設計和記錄他們的 API，我們也看到了一些 API 優先的實施方案。與其他替代方案相比，API 消費者對 OpenAPI 也更為熟悉。因此，爭論每種標準的優劣已經沒有意義，因為 OpenAPI 已經贏得了這場戰爭。