unique-responses-key

Overview

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

Each response must have a unique http status code to clearly identify its purpose and differentiate it from other responses.

Property	Value
Enabled	Yes
Maximum Severity	Error
Message	Duplicate response key found.
Code	OPENAPI3APIMATIC_L460
Type	Linting
Rule System	Semantic
Broad Category	OpenAPI Responses
Products Impacted	API Transformer, Code Generation, Developer Experience Portal
Tags	openapi3 openapi apimatic semantic linting response key unique default status code

Suggested Fixes

• Keep one and remove all other response key definitions which have the same status codes.
• Update response status code to avoid conflict.

For More Information

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