Swagger
Swagger 連接器支援具有下列驗證類型的 swagger 檔案:基本、OAuth 與 App 金鑰。此連接器支援
OpenAPI 2.0 和
OpenAPI 3.0 規格。
連接器發行版本
Swagger 連接器在 8.4.3 發行版本提供。
支援的動作
支援的觸發器
無
支援的授權
Swagger 連接器支援下列授權:
• 「無」
• 「基本」
• OAuth
• 「App 金鑰」
授權 Swagger
必須針對每個 Swagger 連接器動作完成 Swagger 授權。從驗證配置清單中,選取其中一個授權配置:
• 「無」- 提供 Swagger 檔案 URL,例如 https://petstore.swagger.io/v2/swagger.json
• 「基本」- 欲新增基本連線,請執行下列操作:
1. 從驗證配置清單中選取「基本」。
2. 在「Swagger 連線」欄位中,按一下「新增」。
3. 在「新增連線」視窗中,輸入下列詳細資訊:
▪ 「連線標籤」- 會自動填入。您可以提供您選擇的連線標籤。
|
標籤區分大小寫。請勿使用空格、一些特殊字元以及以數字開頭。
|
▪ Swagger Url - Swagger.json 檔案 Url。
▪ 「使用者名稱」- 目標應用程式的使用者名稱。
▪ 「密碼」- 目標應用程式的密碼。
4. 按一下「新增」。新授權即會新增至清單。
• OAuth - 欲新增 OAuth 連線,請執行下列操作:
1. 從驗證配置清單中選取 OAuth。
2. 在 Swagger OAuth 欄位中,按一下「新增 Swagger 登入」。
3. 在參數視窗中,輸入 Swagger URL,然後再按一下「允許」。「新增授權」視窗即會開啟。
4. 在「新增授權」視窗中,必要時編輯「授權標籤」,然後輸入資源 URL。
5. 按一下「新增」。
• 「App 金鑰」- 欲新增應用程式金鑰連線,請執行下列操作:
1. 從驗證配置清單中,選取「App 金鑰」。
2. 在「Swagger App 金鑰」欄位中,按一下「新增」。
3. 在「新增連線」視窗中,輸入下列詳細資訊:
▪ 「連線標籤」- 會自動填入。您可以提供您選擇的連線標籤。
|
標籤區分大小寫。請勿使用空格、一些特殊字元以及以數字開頭。
|
▪ Swagger Url - Swagger.json 檔案 URL,例如 https://petstore.swagger.io/v2/swagger.json
▪ 「App 金鑰」- 輸入 Swagger App 金鑰。
4. 按一下「新增」。
Swagger 連接器限制
• 在 OpenAPI 3.0 規格中,伺服器欄位提供一個可定義多個基礎 URL 的選項。目前實行不支援此選項,將從伺服器陣列中取得第一個基礎 URL。
• 請求中允許下列媒體類型:application/json 與 application/x-www-form-urlencoded。不允許萬用字元。對於回應,允許 application/json。
• 不支援對檔案或圖像進行上載與下載。
• 不支援 Multipart 或 form data。
• 參數序列化方法是所有參數的預設值。
• 不支援在類型欄位中使用 "one of"、"anyOf"、"allOf" 與 "not"。
• 不允許多個驗證。所有 API 的驗證應該都類似。