OpenAPI / Swagger valideren op https://docs.discourse.org/openapi.json

Thanks for bringing this up.

No, this is the only spec file available.

I did make many change to bring the docs from swagger 2.0 to openapi 3.0 in this commit:

https://github.com/discourse/discourse_api_docs/commit/9d688aaaf2484be7e6fcd139be5da0bef079e103

but looks like some things were overlooked or are possibly new changes to the spec.

I just verified again with the openapi-cli command line tool to check for errors and I’m able to reproduce similar errors as the swagger site:

blake@pop-os ~/code/discourse_api_docs (master) $ npx @redocly/openapi-cli lint openapi.json
...
❌ Validation failed with 647 errors and 579 warnings.

Looks good. If you’d like to submit a patch with these fixes that would be very welcome, but I can also help clean up some of these.

4 likes