API/Resources: Add docs listing the balenaOS versions of a device type

[thgreasi]

Since these do not use the release_tags for picking the versions, I've put this as draft and merge it after https://github.com/balena-io/balena-api/pull/4821 gets released, which bacfills the semver fields of all releases from their release_tags, so that users don't get confused by the v0.0.0 versions.

Depends-on: https://github.com/balena-io/balena-api/pull/4821
Change-type: minor
See: https://balena.zulipchat.com/#narrow/stream/345889-balena-io.2Fos/topic/Determine.20list.20of.20supported.20OS.28hostapp.29.20for.20a.20device-type/
See: https://balena.fibery.io/Work/Task/Add-docs-for-retrieving-the-OS-releases-via-the-hostApp-release-OData-endpoints-1848

---

Please make sure to read the CONTRIBUTING document before opening the PR for relevant information on contributing to the documentation. Thanks!

[chrisys]

I'd suggest putting the public device type first, above and before the private DT one, with description:

'To request a list of the supported balenaOS versions for a particular device type, the deviceType parameter is required. Even though this query only selects the raw_version field, you can additionally specify any of the fields found in the release resource.'

Then the private DT one would have:

'Same as above, but in order to access private device types, you must provide an authentication token'

[myarmolinsky]

Suggested change

	"description": "In order to be able to access balenaOS versions of a private device type, you need to provide your bearer token. The `deviceType` parameter is required. Even though this query only selects the `raw_version` field, you can additionally specify any of the fields found in the `release` resource.",
	"description": "In order to be able to access balenaOS versions of a private device type, you need to provide your bearer token. The `deviceType` parameter is required. Even though this query by default only selects the `raw_version` field, you can additionally specify any of the fields found in the `release` resource.",

[chrisys]

Typo in your suggestion @myarmolinsky

[thgreasi]

I feel that's a bit redundant tbh @myarmolinsky , since the query either selects or doesn't, it's not a default function parameter of a function for example. Lets leave Chris' perfection intact :)

[myarmolinsky]

Typo in your suggestion @myarmolinsky

Thank you :P