Skip to main content

valid-dollar-ref-path

Overview​

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

The '$ref' values must be RFC3986-compliant percent-encoded URIs.

PropertyValue
EnabledYes
Maximum SeverityError
MessageProvided $ref path is invalid.
CodeSWAGGER20SYNTAX_V060
TypeValidation
Rule SystemSyntax
Broad CategoryReferences
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsswagger2 swagger syntax validation $ref uri reference

Suggested Fixes​

  • Ensure that the value of $ref is a valid URI.
  • Ensure that the URI value does not contain any forbidden characters.
  • Ensure that the $ref value is not empty or null.
  • Ensure that the reference path set in the $ref property is a valid path to the component you intend to reference.

For More Information​