non-primitive-any-of-schemas-in-polymorphism

Overview

This rule belongs to the openapi-v3-apimatic-linting ruleset and states that:

It is not allowed to use the schemas with primitive types in anyOf list when discriminator property is defined alongside anyOf. This refers to polymorphism which is the ability of a schema to represent different types or subtypes in the presence of discriminator.

Property	Value
Enabled	Yes
Maximum Severity	Error
Message	Schema with primitive type found in anyOf list which is not allowed in polymorphism.
Code	OPENAPI3APIMATIC_L699
Type	Linting
Rule System	Semantic
Broad Category	OpenAPI Schemas
Products Impacted	API Transformer, Code Generation, Developer Experience Portal
Tags	openapi3 openapi apimatic semantic linting primitive type anyof schema polymorphism discriminator

Suggested Fixes

• Identify the schemas defined in anyOf list.
• Check the type definition of the schema and ensure it is not a primitive type (such as string, number, boolean, etc.).
• Modify the schema's type to be an object type.
• Ensure that the object type includes the necessary properties for representing the polymorphic structure.
• Remove the discriminator property.

For More Information

• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schema-object
• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#discriminator-object
• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md
• https://docs.apimatic.io/rulesets/overview/