New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Validation error on the adme-samples #29

Open

racchen opened this issue Apr 21, 2023 · 0 comments

racchen commented Apr 21, 2023

We noticed the validation error on the adme-samples APIs (Azure Data Manager for Energy – Samples) listed below, which are APIs in this documents Azure Data Manager for Energy - Samples | adme-samples (microsoft.github.io)

CRS Catalog Service - https://microsoft.github.io/adme-samples/rest-apis/crs-catalog-openapi-v2.yaml
CRS Conversion Service - https://microsoft.github.io/adme-samples/rest-apis/crs_converter_openapi.yaml
Indexer Service - https://microsoft.github.io/adme-samples/rest-apis/indexer_openapi.yaml
Notification Service - https://microsoft.github.io/adme-samples/rest-apis/notification_openapi.yaml
Register Service - https://microsoft.github.io/adme-samples/rest-apis/register_openapi.yaml
Search Service - https://microsoft.github.io/adme-samples/rest-apis/search_openapi.yaml
Seismic DDMS Service - https://microsoft.github.io/adme-samples/rest-apis/seismic_ddms_openapi.yaml
Unit Service - https://microsoft.github.io/adme-samples/rest-apis/index.html?page=/adme-samples/rest-apis/unit_service_openapi_v3.yaml

The issue we observed is that some reference in the samples are missing. For example, if I validate the API https://microsoft.github.io/adme-samples/rest-apis/search_openapi.yaml with the Swagger & OpenAPI Online Validator | Swagger Parser (apitools.dev). We can see many errors about missing reference.

for the one highlighted above, I checked in the https://microsoft.github.io/adme-samples/rest-apis/search_openapi.yaml and no reference refer to definition/versionInfo.

For those APIs, we observed similar issues in validation. Any suggestions?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment