내보내기 시 변환
지원하지 않는 형식으로 API Designer 기능으로 설계된 정의를 내보낼 때, 대상 형식에 맞게 정의가 수정됩니다. 이 과정에서 일부 표현력이 손실됩니다.
아래 표는 다음 사양 중 하나로 내보낼 때 API 정의에 적용되는 수정 사항을 설명합니다.
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| 지원되지 않는 기능 | 변환 |
|---|---|
| 구성 요소 | 구성 요소가 사용되는 모든 위치에 복사됩니다. |
| 응답 범위 및 기본 응답 | 응답이 제거됩니다. |
| Bearer 인증 및 OpenID Connect | 보안 체계가 제거됩니다. |
| allOf 조합 | 조합은 사용된 모든 유형의 모든 속성을 포함하는 객체로 대체됩니다. |
| anyOf 및 oneOf 조합 | 조합은 빈 객체로 대체됩니다. |
| 다중 엔드포인트 | 게시된 첫 번째 엔드포인트가 정의에 포함되고 나머지는 무시됩니다. |
OpenAPI Specification 3.0은 서비스 약관 필드에서 URL만 지원합니다. OAS 3.0에서 정의를 내보낼 때 이 필드는 URL이 포함된 경우에만 내보내집니다. 그렇지 않은 경우 정의의 유효성을 보장하기 위해 서비스 약관 필드는 무시됩니다.