Swagger 2.0 Anyof

Question

Tương đương với anyof trong phiên bản Swagger 2.0 là gì, hãy cho tôi biết cách cập nhật tệp json của tôi vì tôi muốn nâng cấp tài liệu của mình từ từ 1.0 đến 2.0.

Cảm ơn bạn đã trợ giúp.

Answer 1

Tôi không nghĩ rằng có một và nó cảm thấy như một thiếu sót lớn. Nó chắc chắn không được đề cập trong the Schema Object portion of the specification. Họ gọi ra các yếu tố đó mà đã được áp dụng từ Schema JSON và anyOf không nằm trong số họ:

Các thuộc tính sau được lấy trực tiếp từ định nghĩa JSON Schema và làm theo các thông số kỹ thuật giống nhau:

• $ ref - là một JSON Reference
• định dạng (Xem Loại định dạng dữ liệu để biết thêm chi tiết)
• tiêu đề
• mô tả (GFM cú pháp có thể được sử dụng cho representat rich text ion)
• mặc định (Không giống như JSON Schema, giá trị phải phù hợp với kiểu định nghĩa cho các đối tượng Schema)
• multipleOf
• tối đa
• exclusiveMaximum
• tối thiểu
• exclusiveMinimum
• maxLength
• minLength
• mẫu
• maxItems
• minItems
• uniqueItems
• maxProperties
• minProperties
• cần
• enum
• loại

Các thuộc tính sau được lấy từ định nghĩa JSON Schema nhưng định nghĩa của chúng đã được điều chỉnh theo Đặc điểm Swagger. Định nghĩa của chúng giống với định nghĩa của JSON Schema, chỉ khi định nghĩa gốc tham chiếu định nghĩa lược đồ JSON, định nghĩa đối tượng lược đồ được sử dụng thay thế.

• mục
• allOf
• tính
• additionalProperties

Tôi nghĩ rằng điều gần gũi nhất là lĩnh vực discriminator, nhưng điều đó có nghĩa là bạn đã có cấu trúc đầu ra của bạn để phù hợp Đi vênh vang.

Answer 2

anyOf và oneOf hiện được hỗ trợ trong OpenAPI Specification 3.0 (phát hành vào ngày 26 tháng 7 năm 2017).