내보내기 시 변환
마지막 업데이트: 2026. 10. 20.API Contracts 기능으로 설계된 정의를 해당 기능을 지원하지 않는 형식으로 내보내는 경우, 정의는 대상 형식에 맞게 수정됩니다. 이 과정에서 일부 표현력이 손실됩니다.
아래 표에서는 다음 사양 중 하나로 내보낼 때 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이 포함된 경우에만 내보내집니다.그렇지 않은 경우, 정의의 유효성을 보장하기 위해 서비스 약관 필드가 무시됩니다.