天天看點

Apifox如何一鍵導入Swagger資料?

Hi,大家好。API 管理文檔是必不可少的一項技能,在這方面 Swagger 做的非常出色。但是管理 API 文檔隻是其中的一部分,還有很多事情 Swagger 無法完成,或者無法高效完成,比如:API 文檔定義、API Mock、API 自動化測試等等,Apifox就是為了解決這個問題而生,Apifox如何一鍵導入Swagger資料?今天給大夥介紹一下Apifox這位新晉高富帥。

Apifox如何一鍵導入Swagger資料?

導入 OpenAPI (Swagger) 資料

支援導入 OpenAPI 3、Swagger 1、2、3 資料格式的 json 或 yaml 檔案。

#手動導入

打開 項目設定 面闆,點選 手動導入 ,可選擇檔案導入或 URL 導入。

#手動導入-檔案導入

可以将 json 或 yaml 檔案拖拽到下圖區域,也可以點選下圖區域通過系統的檔案管理器選擇對應的 json 或 yaml 檔案。

Apifox如何一鍵導入Swagger資料?

#手動導入-URL 導入

注意

需要 URL 導入的時候,需要填寫的是 json 或 yaml 資料檔案的 URL,而不是 Swagger UI 的 URL。

Apifox如何一鍵導入Swagger資料?
Apifox如何一鍵導入Swagger資料?

#導入-進階設定

導入 OpenAPI/Swagger 格式隻包含 接口、資料模型、環境 。

Apifox如何一鍵導入Swagger資料?
  1. 接口覆寫模式
  1. 同 URL 覆寫:當兩個檔案 URL、method 相同時,新檔案會覆寫舊檔案。
  2. 同 URL 且同分組才覆寫:當兩個檔案的 URL、method 相同時,并且在同一個分組下時,新檔案會覆寫舊檔案。
  3. 同 URL 不導入:當兩個檔案 URL、method 相同時,新檔案不會導入。
  4. 同 URL 時保留兩者:當兩個檔案 URL、method 相同時,新檔案會導入,舊檔案不會被删除。
  1. 導入到分組:支援将檔案導入到具體的分組中。
  2. 導入接口用例:開啟開關後,已選擇接口下的 接口用例預設全選,也可以在導入預覽中選擇對應接口用例。
  3. tip:當導入非 Apifox 格式檔案,且接口文檔覆寫時,名稱相同的 接口用例不會導入,不同名稱的接口用例會新增。
  4. 資料模型需要獨立設定 選擇覆寫模式和導入到分組的,如圖

#自動導入

打開 項目設定 面闆,點選 自動導入 ,可設定 多個資料源 ,定時同步到 具體分組 中。

注意

隻有角色為管理者,且打開用戶端的時候,才會按照設定的導入頻率 自動導入 。

其他角色不會觸發自動導入 。

Apifox如何一鍵導入Swagger資料?
Apifox如何一鍵導入Swagger資料?

注意

繼續閱讀