search

openremote / fleet-management

The Fleet Management/Telematics implementation on top of the OpenRemote open-source IoT device management platform.
https://openremote.io/fleet-telematics-open-source/
Other
15 stars 4 forks source link

Fix OpenAPI schema JSON file for use with Postman #10

Closed pankalog closed 3 months ago

pankalog commented 1 year ago

Using this OpenAPI spec parser, I was able to understand that there needs to be a 'version' property in the info Object, as the spec says in their definition.

By adding that property, the file is able to be parsed by postmanlabs/openapi-to-postman, to then be imported as a Postman collection. It's a nice way to test the backend, and with some tweaking in the collection, get OAuth working with refresh tokens as well. This allows full usage of the OpenRemote HTTP API on any deployment/manager runtime, without having to use the frontend authentication of Swagger.

If need be I can attach my collection.json file here so that people can import it and test it out.

pankalog commented 11 months ago

Fix provided here. If we would want to make it consistent with the OpenAPI spec, we would need to generate a version for each release, or use the same version, but we do need to include a version number.

pankalog commented 10 months ago

fixed in openremote/openremote#1201