The file endpoints.yaml contains invalid OpenAPI syntax.
Existing Syntax:
/filtering_terms:
parameters:
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/limit'
get:
description: Get the list of filtering terms handled by this beacon
operationId: getFilteringTerms
tags:
- Informational endpoints
responses:
'200':
$ref: ./responses/beaconFilteringTermsResponse.yaml
default:
description: An unsuccessful operation.
$ref: ./responses/beaconErrorResponse.yaml
Corrected Syntax:
As this file is a response definition, it should be defined as a response object in the OpenAPI specification. The correct syntax should be:
/filtering_terms:
parameters:
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/limit'
get:
description: Get the list of filtering terms handled by this beacon
operationId: getFilteringTerms
tags:
- Informational endpoints
responses:
'200':
description: Successful operation.
content:
application/json:
schema:
$ref: ./responses/beaconFilteringTermsResponse.yaml
default:
description: An unsuccessful operation.
$ref: ./responses/beaconErrorResponse.yaml
The file
endpoints.yaml
contains invalid OpenAPI syntax.Existing Syntax:
Corrected Syntax: As this file is a response definition, it should be defined as a
response
object in the OpenAPI specification. The correct syntax should be:Reference: OpenAPI Specification - Describing Responses
Note: After fixing the
.yaml
files, the.json
should be fixed as well by running the schema conversion script located in the bin folder.