Control Samsung Windfree Air Conditioner with REST API

Developer Programs
1

Hello
I’m trying to control my Samsung Windfree A/C by REST API (next step will be understand if I can use such APIs without cloud in order to let them work with OpenHAB without an internet connection).
I found a github project (GitHub - bradymholt/smartthings-rest-api: SmartThings REST API) with a groovy app and instructions.
When I need to authorise the app to access my devices, I got a blank list. After some research I understand that I can modify the preferences section adding more input that leads to a list of devices that contain such capabilities. I also understand that I need to add “requested:false” if I want to go to next step with the input proposed in the github project (and the blank list).
I noticed that I don’t have a location configured in my smart app, even if I can see the smart app installed in location page.
If I follow the guide using capabilities that my devices offers, I can get a token and a link, but when I use the command to retrieve the device list, the list it’s empty
Can someone help me understanding what I’m doing wrong?
Thanks

2

Welcome to the SmartThings Community, @paciotti!

You can use the SmartThings API which is accessible for all, you just need to:

  1. Get a Personal Access Token to use it in the authorization header of the request. This is an example using Postman:

    deviceListReq
    deviceListReq1102×699 109 KB

  2. Send the request to the corresponding endpoint:

    • List devices > https://api.smartthings.com/v1/devices
    • Get device status > https://api.smartthings.com/v1/devices/{deviceId}/status
    • Send a Command to the device > https://api.smartthings.com/v1/devices/{deviceId}/commands

You need an Internet connection to execute these API requests as they don’t run locally.
If your Samsung Windfree A/C device is configured to run locally, you can create automations within the SmartThings app that would run that way.
You can verify this by creating a “test” automation using only this device and other local functions like “Time” because when you finish, the automation appears in the list with a house (:houses:) icon.

3

Hi - you might be interested in my POST/GET Edge driver if you can issue your http requests locally. If they have to go through the cloud, then nevermind!

4

How do you configure your windfree ac to run locally?

5

That depends on the device type and its handler (type and/or configuration). For example:

  • Not all devices can be accessed through a LAN connection and can be only controlled by making requests to their cloud
  • Edge drivers run locally by default but this kind of devices must still be using DTH and the manufacturer needs to define that explicitly.
  • This kind of device use OCF which works differently (check more details here)

I suggest you contact the Customer Support team of Samsung to let them know you’re interested in local integration for this device, they might have more info about that.

Related to this post: Hub Connected Devices Now Use Edge Drivers - #109 by Robert_Singh