배열 내의 OpenAPI 여러 유형

Question

여러 유형이 포함 된 배열을 허용하는 OpenAPI 3을 사용하여 재사용 가능한 스키마 구성 요소를 정의하는 데 문제가 있습니다. 각 항목 유형은 동일한 상위 클래스에서 상속되지만 특정 하위 속성을가집니다. 이것은 SwaggerHub의 model보기에서 올바르게 작동하는 것으로 보이지만 예제보기에서는 데이터가 올바르게 표시되지 않습니다.

TLDR; OpenAPI 3에서 다른 객체 유형을 포함하는 배열을 정의하는 방법이 있습니까?

Response: 
    allOf: 
    - $ref: '#/components/schemas/BaseResponse' 
    - type: object 
     title: A full response 
     required: 
     - things 
     properties: 
     things: 
      type: array 
      items: 
      anyOf: 
       - $ref: '#/components/schemas/ItemOne' 
       - $ref: '#/components/schemas/ItemTwo' 
       - $ref: '#/components/schemas/ItemThree' 

Answer 1

스펙이 정확합니다. oneOf 및 anyOf의 예제 렌더링은 Swagger UI에서 아직 지원되지 않습니다. 당신은 상태 업데이트를 이러한 문제를 추적 할 수 있습니다

OAS 3.0 Support Backlog
Multiple responses using oneOf attribute do not appear in UI