Discriminator 사용하기

특정 시나리오에서는 하나의 객체가 여러 구조적 형태를 가질 수 있습니다. 예를 들어, 책은 eBook일 수도 있고 페이퍼백일 수도 있습니다. 이러한 경우 discriminator 필드를 사용하여 서로 다른 스키마 유형을 구분할 수 있습니다.

discriminator는 일반적으로 oneOf 또는 anyOf와 함께 사용되어 "특정 필드의 값이 객체의 구체적인 유형을 결정한다"는 것을 나타냅니다.

속성	설명
propertyName	유형을 구분하는 데 사용되는 필드 이름을 지정합니다.
mapping	필드 값과 해당 스키마 간의 매핑을 정의합니다.

Apidog에서 구성하기

방법 1: JSON Schema 사용하기

시각적 인터페이스를 통해 oneOf 구성하기

API의 요청 또는 응답 편집기를 엽니다. "Schema Composition" 필드로 정의하려는 필드를 선택합니다. Advanced Settings > Schema Composition > oneOf를 클릭하고, oneOf에서 결합하려는 스키마(예: eBook 및 Paperback)를 참조합니다.