구성 요소를 사용하면 API 전반에서 다양한 요소를 재사용할 수 있습니다. 이러한 요소는 다음과 같습니다.
경로 변수
쿼리 매개 변수
헤더
응답
조합
조합을 사용하면 여러 다른 데이터 유형을 결합하여 새로운 데이터 유형을 생성할 수 있습니다. API Designer는 두 가지 유형의 조합을 지원합니다.
구성(allOf)을 사용하면 서로 다른 스키마의 스키마 속성을 집계할 수 있습니다. 예를 들어, 기존 유형인 Contact 및 Error의 모든 속성을 재사용하여 데이터 유형 Company를 정의할 수 있습니다.
다형성(oneOf/anyOf)을 사용하면 서로 다른 데이터 유형의 속성을 사용할 수 있는 엔터티를 생성할 수 있습니다.
oneOf를 사용하면 선택한 유형 중 하나의 속성을 포함하는 데이터 유형을 정의할 수 있습니다. 예를 들어, 서비스 계정에 대한 정보를 가져오는 작업을 생성하는 경우 oneOf 조합을 사용하여 응답을 정의함으로써 Error의 모든 속성 또는 ServiceAccountCount의 모든 속성을 가져올 수 있습니다.
anyOf를 사용하면 선택한 유형 중 하나 또는 여러 개의 속성을 포함하는 데이터 유형을 정의할 수 있습니다. 예를 들어, 서로 다른 속성을 포함하는 데이터 유형 nervousSystem 및 유형 skeleton을 정의하고 anyOf 조합을 사용하여 이 두 유형 중 하나의 속성을 포함하는 데이터 유형을 생성할 수 있습니다.
anyOf 조합은 선택한 데이터 유형 중 하나 이상의 모든 필수 매개 변수를 포함하는 한 유효합니다. 아래 예에서는 nervousSystem 유형의 brain_weight 속성과 skeleton의 skull_height 및 teeth 속성을 사용합니다.
