匯入 API
Restorm 能辨識 二十四種格式，並依據它們重建一棵完整的專案樹：資料夾、請求、 環境、API 文件、列舉。
這幾乎永遠是最好的起點：既然已經有規格文件，就不必再手寫請求。
檔案 ▸ 匯入（Ctrl+I）接受：
- 磁碟上的檔案；
- URL — 對於線上提供的
swagger.json或$metadata特別方便； - 貼上的內容 — 把一道
curl命令變成請求就是這樣做的。
Restorm 會自行判斷格式：先看檔案的副檔名，再分析內容。您無須做任何選擇。
API 規格
Section titled “API 規格”| 格式 | 頁面 |
|---|---|
| OpenAPI 3.x 與 Swagger 2.0 | OpenAPI / Swagger |
| GraphQL 結構（SDL） | GraphQL |
.proto 檔案與 gRPC 反射 | gRPC |
| WSDL | SOAP / WSDL |
| AsyncAPI | AsyncAPI |
| OData EDMX / CSDL | OData |
| OpenRPC | OpenRPC |
| tRPC 結構 | tRPC |
| Smithy | Smithy |
| TypeSpec | TypeSpec |
| RAML | RAML |
| WADL | WADL |
| Thrift | Thrift |
| API Blueprint | API Blueprint |
其他用戶端的集合
Section titled “其他用戶端的集合”| 格式 | 頁面 |
|---|---|
| Postman | Postman |
| Insomnia | Insomnia |
| Bruno | Bruno |
| Thunder Client | Thunder Client |
| Paw / RapidAPI | Paw |
| HTTPie | HTTPie |
VS Code REST Client（.http） | REST Client |
擷取內容與命令列
Section titled “擷取內容與命令列”| 格式 | 頁面 |
|---|---|
| HAR（瀏覽器擷取） | HAR |
curl 命令 | cURL |
Invoke-RestMethod / Invoke-WebRequest | PowerShell |
您會得到什麼
Section titled “您會得到什麼”依來源格式的豐富程度而定：
- 一個環境資料夾，內含一個或多個環境，基底 URL 取自規格文件；
- 一棵資料夾樹狀結構 — 依格式而定，可能按標籤、按服務或按資源劃分；
- 每個操作一個請求，型別對應到相應的協定；
- 附加在資料夾上的 API 文件：模型、描述、安全性結構、範例回應；
- 規格文件中的列舉，可作為值型別重複使用；
- 預先接好線的身分驗證標頭及其變數 — 請參閱 身分驗證。
匯入完成後，任何值解析結果為空的鍵／值配對都會自動停用：您第一次傳送時， 不會帶著一大堆空白標頭出門。
匯入 API 的文件
Section titled “匯入 API 的文件”匯入不只產生請求：它還保留該 API 的文件 — 描述、模型、安全性、範例、列舉， 都能在所建立資料夾的 Docs 分頁中查閱。請參閱 存取與更新已匯入 API 的文件。
更新一次匯入
Section titled “更新一次匯入”有十二種格式支援重新同步：Restorm 會把來源的新版本與現有的樹狀結構相比， 只套用差異，不會遺失您所做的修改。請參閱 從來源更新。
Restorm 會為每個請求產生程式碼片段，涵蓋其協定所有相關的語言。請參閱 程式碼匯出。