TABLE OF CONTENTS
1 Introduction .......................................................................................................................................... 2
2 Authentication ...................................................................................................................................... 3
2.1 Oauth2 Fundamentals ....................................................................................................................................... 3
2.1.1 Oauth Roles ............................................................................................................................................... 3
2.1.2 Third Party Client Application Registration ............................................................................................... 3
2.1.3 Client ID and Client Secret ......................................................................................................................... 3
2.2 Oauth2 Authorization Code Grant Type ............................................................................................................ 4
2.2.1 Refresh Token ............................................................................................................................................ 5
2.3 Open API OAuth2 Implementation ................................................................................................................... 5
2.3.1 Web Interface ............................................................................................................................................ 5
2.3.2 Programmatic Interface............................................................................................................................. 7
2.4 Oauth2 Best Practices ..................................................................................................................................... 10
3 API ..................................................................................................................................................... 12
3.1 Status Requests ............................................................................................................................................... 12
3.1.1 Devices ..................................................................................................................................................... 12
3.1.2 Device State ............................................................................................................................................. 14
3.2 Command Requests ......................................................................................................................................... 14
3.2.1 Device – State .......................................................................................................................................... 15
3.2.2 Device – Setpoint ..................................................................................................................................... 15
3.2.3 Device – Mode ......................................................................................................................................... 15
3.2.4 Device – Speed ........................................................................................................................................ 16
4 Errors ................................................................................................................................................. 17