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