Swagger
Swagger 커넥터는 기본, OAuth 및 앱 키와 같은 인증 유형으로 Swagger 파일을 지원합니다. 이 커넥터는
OpenAPI 2.0 및
OpenAPI 3.0 사양을 지원합니다.
커넥터 릴리즈 버전
Swagger 커넥터는 8.4.3 릴리즈에서 제공되었습니다.
지원되는 작업
지원되는 트리거
없음
지원되는 승인
Swagger 커넥터는 다음 승인을 지원합니다.
• 없음
• 기본
• OAuth
• 앱 키
Swagger 승인
각 Swagger 커넥터 작업에 대해 Swagger 승인이 수행되어야 합니다. 인증 구성표 목록에서 승인 구성표 중 하나를 선택합니다.
• 없음 - Swagger 파일 URL(예: https://petstore.swagger.io/v2/swagger.json)을 제공합니다.
• 기본 - 기본 연결을 추가하려면 다음을 수행합니다.
1. 인증 구성표 목록에서 기본을 선택합니다.
2. Swagger 연결 필드에서 새로 추가를 클릭합니다.
3. 연결 추가 창에 다음 세부 정보를 입력합니다.
▪ 연결 레이블 - 자동으로 채워집니다. 원하는 연결 레이블을 제공할 수 있습니다.
 |
레이블은 대/소문자를 구분합니다. 공백, 일부 특수 문자 및 앞에 오는 숫자는 사용할 수 없습니다.
|
▪ Swagger URL - Swagger.json 파일 URL입니다.
▪ 사용자 이름 - 대상 응용 프로그램의 사용자 이름입니다.
▪ 암호 - 대상 응용 프로그램의 암호입니다.
4. 추가를 클릭합니다. 새 승인이 목록에 추가됩니다.
• OAuth - OAuth 연결을 추가하려면 다음을 수행합니다.
필수조건 - 새 OAuth 연결을 추가하기 전에
커넥터 OAuth 설정 구성 항목의 Swagger 단원에 나오는 단계를 따라야 합니다.
1. 인증 구성표 목록에서 OAuth를 선택합니다.
2. Swagger OAuth 필드에서 새 Swagger 로그인 추가를 클릭합니다 Swagger.
3. '매개 변수' 창에서 Swagger URL을 입력한 다음 허용을 클릭합니다. '승인 추가' 창이 열립니다.
4. 필요한 경우, '승인 추가' 창에서 승인 레이블을 편집한 다음 리소스 URL을 입력합니다.
5. 추가를 클릭합니다.
• 앱 키 - 새 앱 키 연결을 추가하려면 다음을 수행합니다.
1. 인증 구성표 목록에서 앱 키를 선택합니다.
2. Swagger 앱 키 필드에서 새로 추가를 클릭합니다.
3. 연결 추가 창에 다음 세부 정보를 입력합니다.
▪ 연결 레이블 - 자동으로 채워집니다. 원하는 연결 레이블을 제공할 수 있습니다.
|
|
레이블은 대/소문자를 구분합니다. 공백, 일부 특수 문자 및 앞에 오는 숫자는 사용할 수 없습니다.
|
▪ Swagger URL - Swagger.json 파일 URL(예: https://petstore.swagger.io/v2/swagger.json)
▪ 앱 키 - Swagger 앱 키를 입력합니다.
4. 추가를 클릭합니다.
|
|
테스트를 클릭하여 승인의 유효성을 검사합니다.
|
Swagger 커넥터 제한 사항
• OpenAPI 3.0 사양에서는 서버 필드에 여러 기본 URL을 정의하는 옵션이 있습니다. 현재 구현에서는 이 옵션을 지원하지 않고 대신 첫 번째 기본 URL을 서버 배열에서 가져옵니다.
• 요청에는 application/json 및 application/x-www-form-urlencoded 미디어 유형이 허용됩니다. 와일드 카드는 허용되지 않습니다. 응답의 경우 application/json이 허용됩니다.
• 파일 또는 이미지 업로드 및 다운로드는 지원되지 않습니다.
• 여러 부품 또는 양식 데이터는 지원되지 않습니다.
• 매개 변수 직렬화 방법은 모든 매개 변수에 대해 기본값입니다.
• 유형 필드에는 "one of", "anyOf", "allOf" 및 "not"을 사용할 수 없습니다.
• 다중 인증이 허용되지 않습니다. 모든 API는 유사한 인증을 가져야 합니다.