resolvable-reference
Overview
This rule belongs to the input-file-validation ruleset and states that:
If a component is referenced using a local or external reference path, the path must be resolvable.
| Property | Value |
|---|---|
| Enabled | Yes |
| Maximum Severity | Blocking |
| Message | Reference could not be resolved. |
| Code | INPUTFILE_V200 |
| Type | Validation |
| Rule System | Semantic |
| Broad Category | References Rules |
| Tags | api specification api file validation reference $ref |
Suggested Fixes
- If this is a local reference, make sure that the component exists at the path specified. A local reference usually starts with a
#. - If this is an external reference to a local file, make sure that the relative path to the file is valid and the component exists in that file.
- If your spec is split into multiple files, ensure you are uploading all of them using a ZIP file.
- If this is an external reference to a file via a URL, make sure that the URL is publicly accessible.