valid-location-for-file-type-parameter

Overview

This rule belongs to the swagger-v2-standards-validation ruleset and states that:

For file type parameters, the parameter's location must be formData. Form is the only parameter type that can be used to send files, thus supporting the file type.

Property	Value
Enabled	Yes
Maximum Severity	Error
Message	Invalid parameter location for file type parameter found.
Code	SWAGGER20STANDARDS_V107
Type	Validation
Rule System	Semantic
Broad Category	Parameters
Products Impacted	API Transformer, Code Generation, Developer Experience Portal
Tags	swagger2 swagger standards semantic validation location parameter type file

Suggested Fixes

• Ensure that the in property of the parameter contains the value formData.
• Location value is compared in a case-sensitive manner.
• Ensure that the value for parameter location is not null or empty.

For More Information

• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md
• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md#parameter-object
• https://www.w3.org/TR/html401/interact/forms.html#h-17.13.4
• https://docs.apimatic.io/rulesets/overview/