non-conflicting-schema-property-name-and-schema-title

Overview

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

Schema title and property names should not conflict with each other. Each schema should have a unique title that serves as its identifier, and property names within the schema should also be unique. Conflicts occur when a schema title is the same as a property name, leading to ambiguity and potential issues with the interpretation of the schema.

Property	Value
Enabled	Yes
Maximum Severity	Warning
Message	Schema title and property name conflict with each other.
Code	OPENAPI3CODEGEN_L621
Type	Linting
Rule System	Semantic
Broad Category	OpenAPI Schemas
Products Impacted	API Transformer, Code Generation, Developer Experience Portal
Tags	code generation sdks openapi3 openapi semantic linting apimatic properties schema key conflict

Suggested Fixes

• Update schema title to ensure uniqueness and remove the conflict.

For More Information

• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#components-object
• 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
• https://docs.apimatic.io/rulesets/overview/