PostIn 是一款開源免費的接口管理工具,工具支持一鍵安裝,頁面設計簡潔易用。本文將詳細介紹如何將swagger、OpenApi數據遷移到PostIn,以實現平滑切換。

1、創建項目

通過創建項目可以幫助開發團隊有效地集中管理項目相關的接口資源,使得團隊成員能夠快速查找和使用所需的 API 信息。

點擊項目→添加項目,可添加公共或者私密的項目,其中公共項目所有用户可瀏覽,私密項目僅選擇的用户可瀏覽。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#接口管理工具

添加項目頁面

屬性

是否必填

描述

項目名稱

必填

為項目設置一個簡潔明瞭的名稱,便於識別和管理。

可見範圍

必填

設定項目的可見性,如“私密”或“公共”,以控制項目的訪問權限,選擇“私密”可限制特定成員進入項目。

成員選取

選填

可見範圍選擇“私密”才展示成員選取選擇框,從系統用户中添項目成員,併為成員分配適當的角色和權限,確保協作效率。

描述

選填

項目提供簡短的描述,説明項目的目標或關鍵內容,幫助團隊成員快速瞭解項目背景。

項目創建完成之後,在項目頁面“所有項目”,或者“我創建的”找到創建的項目。點擊項目名稱,進入項目詳情。

2、導入swagger 2.0接口

進入項目詳情後,點擊接口管理,進入接口列表。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#OpenAPI_02

接口管理

點擊左側接口列表“+”號,選擇導入。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#OpenAPI_03

導入接口

選擇類型為Swagger。拖拽或者點擊上傳區域上傳接口json文件。文件上傳後,系統會自動校驗格式,格式符合要求,點擊提交導入接口

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#接口管理工具_04

校驗格式

格式檢驗失敗,系統會進行提醒。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_文件上傳_05

校驗失敗

導入成功之後,點擊接口對接口進行瀏覽。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_文件上傳_06

瀏覽接口

3、導入OpenApi 3.0/3.1接口

進入項目詳情後,點擊接口管理,進入接口列表。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#OpenAPI_07

接口管理

點擊左側接口列表“+”號,選擇導入。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#swagger_08

導入接口

選擇到如類型為OpenApi。拖拽或者點擊上傳區域上傳導出文件。文件上傳後,系統會自動校驗格式,格式符合要求,點擊提交導入接口

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_上傳_09

校驗格式

格式檢驗失敗,系統會進行提醒。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#OpenAPI_10

校驗失敗

導入成功之後,點擊接口對接口進行瀏覽。

PostIn從初級到進階(6) - 如何導入swagger、OpenApi數據,實現數據遷移_#接口管理工具_11

瀏覽接口

至此,成功將Swagger、OpenApi接口遷移到PostIn。