Schema changes HC2 -> HC3 and lack of references

[Henn Sarv 0]

I'm not sure how important it is, but I jump into this hole

 

"lastWorkingRoute and neighborList shemas are changed from HC2 to HC3

HC2 /api/devices/id produces JSON wtih following: "lastWorkingRoute": "[1,422,59]"
HC3 /api/devices/ID produces a bit changed JSON: "lastWorkingRoute": [1,422,59]

What is difference - HC2 gives me string representation of array but HC3 gives me array. For developer perspective this is quite big difference (agree - important only for tech apps)

Is there SOMEWHERE some kind of DOCUMENTATION of that kind things, changes, schemas

Both HC2 /docs and and HC3 swagger lack several important interfaces like 

/api/energy and /api/temperature

why they are hidden or where to find SOME kind of reference 

[Henn Sarv 0]

not only lastWorkingRoute - more properties are changed in schema

 

HC2: dead: "false",

HC3: dead: false,

 

You can find several similar "changes" in API might be surprizing in development

[Guest torneset]

@A.Socha - Do you have any public updated documentation for these changes?

 

Thank you

[A.Socha 112]

@tornesetYou got API documentation in swager on HC3

Some documentation you will find on manuals like

Please login or register to see this link.

Please login or register to see this link.

Please login or register to see this link.

[Guest torneset]

@A.Socha I am aware of the swagger. Just wondered if there was any public documentation of where there is compatibility between HC2 and HC3 API's and where it is changed. 

Is there any situations where these schema properties might change in the future or will we then see a new version of the API for devices?

[A.Socha 112]

We have no such comparison between HC2 and HC3.
All panels in HC3 are improved or completely new hence most API changes are related to them.  However I can not promise that API will not change. When we add something new sometimes we have to change it. Such will be e.g. 5.091 where in order to better support blinds, awnings and shutters API changes were also needed.

[Guest torneset]

@A.Socha Thank you for quick reply