Thanks for trying out the API. You're right our docs need some improvement here, we write these from the backend and generate them using our own custom swagger parser. We'll fix these asap! We've started adding provider specific docs like this here, https://docs.tryvital.io/wearables/providers/Guides/Freestyl... we'll be adding the rest as soon as possible.
This is why aggregating and standardising the data is hard, some API's are not public and in some cases we use credentials to generate access tokens which we then use to query the API, since we are aiding people in accessing their own data, we take a stance that people have a right to their own health data.
If the internal API does change there is some risk of breakage, we have built a tonne of monitoring around this to ensure that we stay up to date with this and react accordingly.
This is why aggregating and standardising the data is hard, some API's are not public and in some cases we use credentials to generate access tokens which we then use to query the API, since we are aiding people in accessing their own data, we take a stance that people have a right to their own health data.
If the internal API does change there is some risk of breakage, we have built a tonne of monitoring around this to ensure that we stay up to date with this and react accordingly.