Skip to main content

request-body-encoding-explode-only-for-form-url-encoded-media-type

Overview

This rule belongs to the openapi-v3-standards-validation ruleset and states that:

In an OpenAPI v3.0.x document, the Encoding Object referenced by a Request Body Object content definition must configure explode only if the content media type is set as application/x-www-form-urlencoded. If explode is defined for a different request body media type, it will be ignored.

PropertyValue
EnabledYes
SeverityWarning
MessageProperty explode in the Encoding Object is not applicable for current request body media type.
CodeOPENAPI3STANDARDS_V152
TypeValidation
Rule SystemSemantic
Broad CategoryEncoding
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic validation explode encoding request body url encoded media type

Suggested Fixes

  • Remove property explode from the Encoding Object.
  • Ensure that the Encoding Object is defined inside a media type definition that supports configuration of explode.

For More Information