Jump to content

Welcome to Smart Home Forum by FIBARO

Dear Guest,

 

as you can notice parts of Smart Home Forum by FIBARO is not available for you. You have to register in order to view all content and post in our community. Don't worry! Registration is a simple free process that requires minimal information for you to sign up. Become a part of of Smart Home Forum by FIBARO by creating an account.

 

As a member you can:

  •     Start new topics and reply to others
  •     Follow topics and users to get email updates
  •     Get your own profile page and make new friends
  •     Send personal messages
  •     ... and learn a lot about our system!

 

Regards,

Smart Home Forum by FIBARO Team


  • 0

Schema changes HC2 -> HC3 and lack of references


Henn Sarv
 Share

Question

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 

Link to comment
Share on other sites

6 answers to this question

Recommended Posts

  • 0
  • Inquirer
  • 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

    Link to comment
    Share on other sites

    • 0

    @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.

    Link to comment
    Share on other sites

    • 0

    @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?

    Link to comment
    Share on other sites

    • 0

    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.

    Link to comment
    Share on other sites

    Join the conversation

    You can post now and register later. If you have an account, sign in now to post with your account.

    Guest
    Answer this question...

    ×   Pasted as rich text.   Paste as plain text instead

      Only 75 emoji are allowed.

    ×   Your link has been automatically embedded.   Display as a link instead

    ×   Your previous content has been restored.   Clear editor

    ×   You cannot paste images directly. Upload or insert images from URL.

     Share

    ×
    ×
    • Create New...